This skill should be used when the user says "arness code plan", "arn-code-plan", "plan this", "write a plan", "create plan", "implementation plan", "plan feature", "plan the spec", "plan from spec", "generate plan", "arness code plan FEATURE_X", "plan the bugfix", "plan bugfix", "make a plan", or wants to generate an implementation plan from a Arness specification. The skill invokes the arn-code-feature-planner agent to generate the plan, presents it for review, and iterates on user feedback until approved. Produces a PLAN_PREVIEW file that feeds into /arn-code-save-plan.
86
83%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description excels at trigger term coverage and completeness, providing an extensive list of natural phrases that would activate the skill and clearly stating both what it does and when to use it. Its main weakness is that the specificity of capabilities could be improved by describing what the generated plan actually contains or what types of features/bugfixes it can plan. The description is functional and well-targeted for skill selection purposes.
Suggestions
Add more detail about what the generated plan contains (e.g., 'Generates step-by-step implementation plans including file changes, dependencies, and task ordering from Arness specifications').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (implementation plan generation from Arness specifications) and some actions (invokes agent, presents for review, iterates on feedback, produces PLAN_PREVIEW file), but the core actions are more about the workflow mechanics than concrete capabilities. It's somewhat specific but not comprehensively listing what the plan contains or what kinds of planning it supports. | 2 / 3 |
Completeness | The description clearly answers both 'what' (invokes arn-code-feature-planner agent to generate implementation plans from Arness specifications, presents for review, iterates on feedback, produces PLAN_PREVIEW file) and 'when' (explicit list of trigger phrases and the general condition 'wants to generate an implementation plan from a Arness specification'). The 'Use when' equivalent is the opening clause. | 3 / 3 |
Trigger Term Quality | The description includes an extensive list of natural trigger phrases users would say: 'plan this', 'write a plan', 'create plan', 'implementation plan', 'plan feature', 'plan the spec', 'plan from spec', 'generate plan', 'plan the bugfix', 'make a plan', plus the specific command variants. This provides excellent coverage of natural language variations. | 3 / 3 |
Distinctiveness Conflict Risk | The description is highly distinctive with its specific tool name (arn-code-feature-planner), specific ecosystem (Arness specifications), specific output (PLAN_PREVIEW file), and downstream skill reference (/arn-code-save-plan). This creates a clear niche that is unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted orchestration skill with excellent actionability and workflow clarity — every step has concrete instructions, agent invocation templates, and clear branching logic. The main weaknesses are moderate verbosity (some sections could be tightened) and the monolithic structure that could benefit from splitting detailed agent context templates or error handling into separate reference files. Overall it's a strong skill that would effectively guide Claude through the plan generation pipeline.
Suggestions
Consider extracting the agent invocation context templates (Steps 3.5, 4, 5b) into a separate reference file to reduce the main skill's length and improve progressive disclosure.
Remove the duplicate 'Arness not configured' message — it appears in both Prerequisites and Step 1; keep it only in Step 1 where the actual check occurs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is fairly detailed and well-structured, but includes some verbosity that could be tightened — e.g., repeating the 'Arness not configured' message twice, spelling out every pattern file individually, and the lengthy Step 3.5 drift detection section with extensive branching explanations. However, it mostly avoids explaining concepts Claude already knows. | 2 / 3 |
Actionability | The skill provides highly concrete, step-by-step guidance with exact file paths, specific agent invocation payloads (complete with template context blocks), precise filename derivation rules with examples, and clear branching logic for every decision point. The Task tool invocation blocks are copy-paste ready. | 3 / 3 |
Workflow Clarity | The workflow is clearly sequenced with numbered steps, explicit validation checkpoints (drift detection in Step 3.5, existing PLAN_PREVIEW check in Step 4, user approval gate in Step 5), a well-defined feedback loop with retry/fallback logic (Step 5b), and comprehensive error handling. The feedback loop includes explicit recovery paths for agent resume failures. | 3 / 3 |
Progressive Disclosure | The content is well-organized with clear sections and headers, but it's a monolithic document with no references to supporting files despite being quite long (~200+ lines). The agent invocation templates, error handling details, and drift detection branching logic could potentially be split into referenced files. However, no bundle files exist, so there's nothing to reference — the content is reasonably structured for a standalone file but pushes the boundary of what should be inline. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
1fe948f
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.