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.
64
76%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-plan/SKILL.mdQuality
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.
The description excels at trigger term coverage and completeness, providing an exhaustive list of phrases that would activate this skill and clearly explaining both what it does and when to use it. Its main weakness is that the specificity of capabilities could be improved—it describes the workflow (invoke agent, present, iterate) more than the concrete value delivered. The description is functional and effective for skill selection despite being somewhat verbose.
Suggestions
Add more specific capability details about what the plan contains (e.g., 'generates step-by-step implementation plans with file changes, dependencies, and task ordering') rather than focusing on workflow mechanics.
| 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 user-facing capabilities. | 2 / 3 |
Completeness | 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' (extensive explicit trigger phrases listed at the start). The 'when' guidance is very explicit. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including many variations users would actually say: 'plan this', 'write a plan', 'create plan', 'implementation plan', 'plan feature', 'plan the spec', 'plan from spec', 'generate plan', 'plan bugfix', 'make a plan', plus product-specific terms like 'arness code plan' and 'arn-code-plan'. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive due to the specific product name 'Arness', the specific agent it invokes (arn-code-feature-planner), the specific output artifact (PLAN_PREVIEW file), and the downstream skill reference (/arn-code-save-plan). Unlikely to conflict with generic planning skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is highly actionable and has excellent workflow clarity with well-defined steps, validation checkpoints, and error recovery paths. However, it is severely over-verbose — the content could likely be cut by 40-50% without losing any actionable information, particularly the complex phase upgrade gate (Step 5a) which dominates the document. The monolithic structure would benefit from splitting detailed sub-processes into reference files.
Suggestions
Extract Step 5a (Complex Phase Upgrade Gate) into a separate reference file (e.g., references/complex-phase-gate.md) and summarize it in one paragraph in the main skill, dramatically reducing the SKILL.md length.
Remove explanations of basic operations Claude already knows — e.g., 'Create ~/.arness/ directory and file if they do not exist. If file exists, read first, add or update the key under pipeline:, write back preserving all existing keys' can be reduced to 'Upsert pipeline.complex-phase-upgrade in ~/.arness/workflow-preferences.yaml'.
Condense the spec-finding logic in Step 2 into a compact priority list rather than a verbose if/else narrative — Claude can infer the search strategy from a brief ordered list.
Move the detailed agent context blocks (the multi-line template strings) into reference files or collapse them, since they repeat information already stated in the surrounding prose.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~250+ lines with extensive detail on preference lookups, multi-tier branching, YAML file writing mechanics, and edge cases that could be dramatically condensed. Much of the content (e.g., how to write YAML files, how to strip prefixes from filenames, how to create directories) explains things Claude already knows. The complex phase upgrade gate alone spans dozens of lines for what is essentially a preference-gated prompt. | 1 / 3 |
Actionability | The skill provides highly specific, concrete guidance at every step: exact file paths, exact agent invocation context blocks (copy-paste ready), specific branching logic with explicit options, and precise fallback behaviors. Every decision point has clear instructions for what to do. | 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, approval gate in Step 5), feedback loops (Step 5b iterate cycle), and comprehensive error recovery paths. The pipeline position diagram at the top provides excellent context. | 3 / 3 |
Progressive Disclosure | The content is largely monolithic — everything is inline in one massive file with no references to supporting documents for detailed sub-processes (e.g., the complex phase upgrade gate logic, preference schema details, agent invocation patterns). It references external paths like preferences-schema.md and ensure-config.md but doesn't offload any of its own bulk to separate files. The Step 5a section alone could be its own reference document. | 2 / 3 |
Total | 9 / 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 | |
b9084b6
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.