CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-code-plan

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

Quality

83%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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').

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
AppsVortex/arness
Reviewed

Table of Contents

Is this your skill?

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.