CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-plan

This skill should be used when the user says "arness code plan", "arn-code-plan", "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.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered workflow skill: steps are explicitly sequenced, every branch point (drift severity, preference values, resume failure) has concrete handling, and the agent context blocks are copy-paste ready. The main costs are token-level redundancy — repeated dispatch-convention parentheticals, duplicated config-missing guidance, and an Error Handling section that restates in-line cases — plus the inlined Step 5a preference machinery that belongs in a reference file.

Suggestions

State the agent-dispatch convention (read the model from .arness/agent-models/code.md, see ensure-config.md 'Dispatch convention' for fallback) once and reference it from Steps 3.5, 4, and 5b instead of repeating the full parenthetical three times.

Remove the duplicated '## Arness is not configured' message — it appears verbatim in both Prerequisites and Step 1; keep it in one location only.

Move Step 5a's two-tier preference lookup and ~/.arness/workflow-preferences.yaml write-back details into a reference file, keeping only the branch outcomes (always/never/ask/null) inline.

DimensionReasoningScore

Conciseness

The body is mostly efficient procedural instruction, but there is systematic duplication: the '## Arness is not configured' message appears verbatim in both Prerequisites and Step 1, the parenthetical 'passing the model from .arness/agent-models/code.md as the model parameter (see ${CLAUDE_PLUGIN_ROOT}/skills/arn-code-ensure-config/references/ensure-config.md "Dispatch convention" for fallback)' is repeated three times (Steps 3.5, 4, and 5b fallback), and the Error Handling section restates cases already covered in-line. The opening drift-rationale paragraph ('Specs may have been written days or weeks before being planned. The codebase moves in the meantime...') is mild padding.

3 / 5

Actionability

The guidance is copy-paste ready: exact output paths ('<plans-dir>/PLAN_PREVIEW_<spec-name>.md'), verbatim agent context blocks with full content templates, exact user-facing messages, and fully specified AskUserQuestion prompts with enumerated options (e.g., 'Yes, upgrade all complex phases' / 'No, keep configured tier'). All common cases — spec found/not found, drift severities, resume failure, existing PLAN_PREVIEW — have concrete handling.

5 / 5

Workflow Clarity

The sequence (Steps 1→6 with 3.5, 5a, 5b) is explicit with validation checkpoints throughout: drift detection with severity-based branching before planning, an approval gate before proceeding, and a feedback loop (present → revise via agent resume → re-present) with a fallback on resume failure. Error paths for every failure mode (missing config, no specs, agent crash, file not written, user cancel) are enumerated.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so the skill is a single self-contained SKILL.md with clear section headers, and its cross-plugin references (ensure-config.md, arn-code-feature-planner.md, preferences-schema.md) are clearly signaled with paths one level deep. The gap is that Step 5a (~55 lines) inlines the two-tier preference lookup and YAML write-back logic that would fit a reference file, making the body longer than an ideal overview.

4 / 5

Total

17

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An excellent description that explicitly answers both what the skill does and when to use it, with unusually thorough natural-language trigger coverage including command forms and synonyms. Its one real weakness is distinctiveness: the generic planning triggers ('write a plan', 'make a plan', 'generate plan') are not scoped to the Arness context and would fire on unrelated planning requests.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with comprehensive coverage of the skill's behavior: '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.' No vague language, and the pipeline linkage to save-plan is stated explicitly.

5 / 5

Completeness

Both 'what' and 'when' are explicit: 'This skill should be used when the user says [extensive trigger list]... or wants to generate an implementation plan from a Arness specification' answers when with concrete trigger phrases, and the following sentences answer what (invoke planner agent, present for review, iterate to approval, produce PLAN_PREVIEW).

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive, spanning command forms ('arness code plan', 'arn-code-plan', 'arness code plan FEATURE_X'), natural phrases ('write a plan', 'create plan', 'implementation plan', 'generate plan', 'make a plan'), and domain variants ('plan the spec', 'plan from spec', 'plan feature', 'plan bugfix', 'plan the bugfix'). All the phrasings a user would naturally say are represented.

5 / 5

Distinctiveness Conflict Risk

The skill's niche is clear ('generate an implementation plan from a Arness specification' with Arness-specific triggers like 'arness code plan'), but the generic phrases 'write a plan', 'create plan', 'make a plan', and 'generate plan' would match virtually any planning request regardless of Arness context. This creates overlap risk not just with closely related pipeline skills but with any planning-adjacent intent, matching the anchor 'somewhat specific but could still overlap with similar skills' rather than the minor-overlap anchor above it.

3 / 5

Total

18

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

AppsVortex/arness

Path

plugins/arn-code/skills/arn-code-plan/SKILL.md

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.