From cf994cabb782aece312d52b6e408f205df578a9f Mon Sep 17 00:00:00 2001 From: Tym Rabchuk Date: Sat, 4 Apr 2026 12:43:19 -0400 Subject: [PATCH 1/2] Migrate commands/ to skills/, fix v2.0.0 manifest version - Move all 20 command .md files from commands/ into skills/ - Remove "commands" key from manifest.json, consolidate all 34 entries under "skills" - Bump version to 2.0.1 in both manifest.json and plugin.json (v2.0.0 tag had manifest stuck at 1.3.5) - Update README and CONTRIBUTING docs for new structure --- .claude-plugin/plugin.json | 2 +- CONTRIBUTING.md | 14 ++++----- README.md | 13 ++++++-- manifest.json | 44 +++++++++++++--------------- {commands => skills}/audit.md | 0 {commands => skills}/bugfix.md | 0 {commands => skills}/decompose.md | 0 {commands => skills}/feature.md | 0 {commands => skills}/pr-monitor.md | 0 {commands => skills}/pr-ready.md | 0 {commands => skills}/refactor.md | 0 {commands => skills}/repo-map.md | 0 {commands => skills}/self-improve.md | 0 {commands => skills}/self-lint.md | 0 {commands => skills}/self-migrate.md | 0 {commands => skills}/self-perf.md | 0 {commands => skills}/self-test.md | 0 {commands => skills}/status.md | 0 {commands => skills}/tri-debug.md | 0 {commands => skills}/tri-dispatch.md | 0 {commands => skills}/tri-review.md | 0 {commands => skills}/tri-security.md | 0 {commands => skills}/tri-test-gen.md | 0 {commands => skills}/workflow.md | 0 24 files changed, 39 insertions(+), 34 deletions(-) rename {commands => skills}/audit.md (100%) rename {commands => skills}/bugfix.md (100%) rename {commands => skills}/decompose.md (100%) rename {commands => skills}/feature.md (100%) rename {commands => skills}/pr-monitor.md (100%) rename {commands => skills}/pr-ready.md (100%) rename {commands => skills}/refactor.md (100%) rename {commands => skills}/repo-map.md (100%) rename {commands => skills}/self-improve.md (100%) rename {commands => skills}/self-lint.md (100%) rename {commands => skills}/self-migrate.md (100%) rename {commands => skills}/self-perf.md (100%) rename {commands => skills}/self-test.md (100%) rename {commands => skills}/status.md (100%) rename {commands => skills}/tri-debug.md (100%) rename {commands => skills}/tri-dispatch.md (100%) rename {commands => skills}/tri-review.md (100%) rename {commands => skills}/tri-security.md (100%) rename {commands => skills}/tri-test-gen.md (100%) rename {commands => skills}/workflow.md (100%) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 0fac9f1..a17283b 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "devkit", - "version": "2.0.0", + "version": "2.0.1", "description": "Guardrails and consistency for Claude Code — deterministic workflows, metric-gated improvement loops, and multi-agent consensus", "author": { "name": "5uck1ess" diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 76db13b..58e92f1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -14,19 +14,19 @@ 2. Add `"skills/my-skill.md"` to `manifest.json` 3. See the `skill-authoring` skill for full guidance -## Adding a Command +## Adding an Invocable Skill (formerly "command") -1. Create `commands/my-command.md` with YAML frontmatter: +1. Create `skills/my-skill.md` with YAML frontmatter: ```markdown --- - name: devkit:my-command - description: What this command does. + name: devkit:my-skill + description: What this skill does. --- - # Command Title + # Skill Title Step-by-step workflow. ``` -2. Add `"commands/my-command.md"` to `manifest.json` -3. Include Budget & Early Exit section if the command loops +2. Add `"skills/my-skill.md"` to `manifest.json` +3. Include Budget & Early Exit section if the skill loops 4. Include `[PARALLEL]` markers if steps run concurrently ## Adding an Agent diff --git a/README.md b/README.md index 1342929..30ef856 100644 --- a/README.md +++ b/README.md @@ -288,8 +288,8 @@ devkit/ ├── manifest.json # Plugin manifest ├── ROADMAP.md # Implemented features and future plans ├── PREFERENCES.md # Agent behavior guidelines -├── commands/ # 20 slash commands -│ ├── tri-*.md # Multi-agent commands (5) +├── skills/ # 34 skills (invocable + context-activated) +│ ├── tri-*.md # Multi-agent skills (5) │ ├── self-*.md # Self-improvement loops (5) │ ├── pr-ready.md # PR preparation pipeline │ ├── pr-monitor.md # Post-PR review monitor @@ -300,7 +300,14 @@ devkit/ │ ├── bugfix.md # Bug fix lifecycle │ ├── refactor.md # Refactor lifecycle │ ├── decompose.md # Goal decomposition -│ └── status.md # Health check +│ ├── status.md # Health check +│ ├── changelog.md # Changelog generation +│ ├── doc-gen.md # Documentation generation +│ ├── test-gen.md # Test generation +│ ├── research.md # Deep research +│ ├── scrape.md # URL scraping +│ ├── onboard.md # Codebase onboarding +│ └── ... # + context-activated skills ├── agents/ # 6 agents │ ├── reviewer.md # Opus, worktree isolation │ ├── researcher.md # Sonnet, worktree isolation diff --git a/manifest.json b/manifest.json index e29cf2a..6dd0200 100644 --- a/manifest.json +++ b/manifest.json @@ -1,30 +1,28 @@ { "name": "devkit", - "version": "1.3.5", + "version": "2.0.1", "description": "Guardrails and consistency for Claude Code — deterministic workflows, metric-gated improvement loops, and multi-agent consensus", - "commands": [ - "commands/tri-review.md", - "commands/tri-dispatch.md", - "commands/tri-debug.md", - "commands/tri-test-gen.md", - "commands/tri-security.md", - "commands/self-improve.md", - "commands/self-test.md", - "commands/self-lint.md", - "commands/self-perf.md", - "commands/self-migrate.md", - "commands/pr-ready.md", - "commands/workflow.md", - "commands/status.md", - "commands/bugfix.md", - "commands/feature.md", - "commands/refactor.md", - "commands/decompose.md", - "commands/audit.md", - "commands/pr-monitor.md", - "commands/repo-map.md" - ], "skills": [ + "skills/tri-review.md", + "skills/tri-dispatch.md", + "skills/tri-debug.md", + "skills/tri-test-gen.md", + "skills/tri-security.md", + "skills/self-improve.md", + "skills/self-test.md", + "skills/self-lint.md", + "skills/self-perf.md", + "skills/self-migrate.md", + "skills/pr-ready.md", + "skills/workflow.md", + "skills/status.md", + "skills/bugfix.md", + "skills/feature.md", + "skills/refactor.md", + "skills/decompose.md", + "skills/audit.md", + "skills/pr-monitor.md", + "skills/repo-map.md", "skills/executing.md", "skills/clean-code.md", "skills/dry.md", diff --git a/commands/audit.md b/skills/audit.md similarity index 100% rename from commands/audit.md rename to skills/audit.md diff --git a/commands/bugfix.md b/skills/bugfix.md similarity index 100% rename from commands/bugfix.md rename to skills/bugfix.md diff --git a/commands/decompose.md b/skills/decompose.md similarity index 100% rename from commands/decompose.md rename to skills/decompose.md diff --git a/commands/feature.md b/skills/feature.md similarity index 100% rename from commands/feature.md rename to skills/feature.md diff --git a/commands/pr-monitor.md b/skills/pr-monitor.md similarity index 100% rename from commands/pr-monitor.md rename to skills/pr-monitor.md diff --git a/commands/pr-ready.md b/skills/pr-ready.md similarity index 100% rename from commands/pr-ready.md rename to skills/pr-ready.md diff --git a/commands/refactor.md b/skills/refactor.md similarity index 100% rename from commands/refactor.md rename to skills/refactor.md diff --git a/commands/repo-map.md b/skills/repo-map.md similarity index 100% rename from commands/repo-map.md rename to skills/repo-map.md diff --git a/commands/self-improve.md b/skills/self-improve.md similarity index 100% rename from commands/self-improve.md rename to skills/self-improve.md diff --git a/commands/self-lint.md b/skills/self-lint.md similarity index 100% rename from commands/self-lint.md rename to skills/self-lint.md diff --git a/commands/self-migrate.md b/skills/self-migrate.md similarity index 100% rename from commands/self-migrate.md rename to skills/self-migrate.md diff --git a/commands/self-perf.md b/skills/self-perf.md similarity index 100% rename from commands/self-perf.md rename to skills/self-perf.md diff --git a/commands/self-test.md b/skills/self-test.md similarity index 100% rename from commands/self-test.md rename to skills/self-test.md diff --git a/commands/status.md b/skills/status.md similarity index 100% rename from commands/status.md rename to skills/status.md diff --git a/commands/tri-debug.md b/skills/tri-debug.md similarity index 100% rename from commands/tri-debug.md rename to skills/tri-debug.md diff --git a/commands/tri-dispatch.md b/skills/tri-dispatch.md similarity index 100% rename from commands/tri-dispatch.md rename to skills/tri-dispatch.md diff --git a/commands/tri-review.md b/skills/tri-review.md similarity index 100% rename from commands/tri-review.md rename to skills/tri-review.md diff --git a/commands/tri-security.md b/skills/tri-security.md similarity index 100% rename from commands/tri-security.md rename to skills/tri-security.md diff --git a/commands/tri-test-gen.md b/skills/tri-test-gen.md similarity index 100% rename from commands/tri-test-gen.md rename to skills/tri-test-gen.md diff --git a/commands/workflow.md b/skills/workflow.md similarity index 100% rename from commands/workflow.md rename to skills/workflow.md From 5e76a26b5d9e7bec8b5e3b1b5243bd0a27616410 Mon Sep 17 00:00:00 2001 From: Tym Rabchuk Date: Sat, 4 Apr 2026 12:52:19 -0400 Subject: [PATCH 2/2] Address tri-review findings: changelog, README, CONTRIBUTING fixes - Add CHANGELOG entry for v2.0.1 - Remove duplicate skills/ block in README repo structure - Remove hardcoded skill count from README - Fix orphaned skill-authoring reference in CONTRIBUTING --- CHANGELOG.md | 9 +++++++++ CONTRIBUTING.md | 2 +- README.md | 17 +---------------- 3 files changed, 11 insertions(+), 17 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 68d98ba..0aa2e2c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,14 @@ # Changelog +## 2.0.1 + +### Fixed +- Migrate all 20 command files from `commands/` into `skills/` — completes the command-to-skill conversion started in v2.0.0 +- Remove `"commands"` key from `manifest.json` — all entries now under `"skills"` +- Fix `manifest.json` version (was stuck at `1.3.5` while `plugin.json` was at `2.0.0`) +- Remove duplicate `skills/` block in README repository structure +- Fix orphaned `skill-authoring` reference in CONTRIBUTING.md + ## 2.0.0 ### New Commands diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 58e92f1..09e9a6b 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -12,7 +12,7 @@ Body content (keep under 100 lines). ``` 2. Add `"skills/my-skill.md"` to `manifest.json` -3. See the `skill-authoring` skill for full guidance +3. See the "Adding an Invocable Skill" section below for full guidance ## Adding an Invocable Skill (formerly "command") diff --git a/README.md b/README.md index 30ef856..8eb22cb 100644 --- a/README.md +++ b/README.md @@ -288,7 +288,7 @@ devkit/ ├── manifest.json # Plugin manifest ├── ROADMAP.md # Implemented features and future plans ├── PREFERENCES.md # Agent behavior guidelines -├── skills/ # 34 skills (invocable + context-activated) +├── skills/ # Invocable + context-activated skills │ ├── tri-*.md # Multi-agent skills (5) │ ├── self-*.md # Self-improvement loops (5) │ ├── pr-ready.md # PR preparation pipeline @@ -315,21 +315,6 @@ devkit/ │ ├── test-writer.md # Sonnet, worktree isolation │ ├── documenter.md # Haiku, worktree isolation │ └── security-auditor.md # Opus, worktree isolation -├── skills/ # 14 skills (6 context-activated workflows + 8 principles/tools) -│ ├── test-gen.md # Auto: "write tests for X" -│ ├── doc-gen.md # Auto: "document this module" -│ ├── changelog.md # Auto: "generate a changelog" -│ ├── onboard.md # Auto: "explain this codebase" -│ ├── research.md # Auto: "research X" -│ ├── scrape.md # Auto: "scrape this URL" -│ ├── executing.md # Principle: methodical execution -│ ├── clean-code.md # Principle: readability -│ ├── dry.md # Principle: don't repeat yourself -│ ├── yagni.md # Principle: no speculative features -│ ├── dont-reinvent.md # Principle: use existing solutions -│ ├── stuck.md # Principle: loop recovery -│ ├── gcli.md # Tool: Google Workspace CLI -│ └── creating-workflows.md # Tool: YAML workflow authoring ├── hooks/ # 8 hooks │ ├── hooks.json # Hook config (auto-loaded) │ ├── safety-check.sh # Dangerous operation blocker