CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

arn-code-save-plan

This skill should be used when the user says "save plan", "save the plan", "arness code save plan", "structure this plan", "create project from plan", "export plan", "export project plan", "organize this plan", "set up project structure", "turn this into a project", "generate project structure", "finalize the plan", or wants to convert a planning conversation into an actionable phased project structure with implementation and testing plans.

Quality

90%

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

92%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.

An exemplary orchestration skill body: every step is sequenced, validated, and actionable, with templates and auxiliary procedures correctly offloaded to real one-level-deep reference files. The only trims available are a couple of long conditional paragraphs that could be broken into reference files or tightened.

DimensionReasoningScore

Conciseness

The body is dense and operational, assumes Claude's intelligence ('Use Claude's intelligence to interpret the source material... Do NOT rely on exact section name matching') and defers bulk material to references. A few passages could be tightened — notably the long single-paragraph 'Finding sketch artifacts' conditional chain and the dense modelOverride bullet — so it sits just below the 'every token earns its place' anchor.

4 / 5

Actionability

Guidance is fully executable: a copy-paste script invocation ('bash ${CLAUDE_PLUGIN_ROOT}/skills/arn-code-save-plan/scripts/save_plan.sh <PROJECT_NAME> <OUTPUT_DIR> <resolved-plan-file-path>'), exact filenames for every created artifact, a section-to-source mapping table, explicit TASKS.md numbering rules, a field-by-field PROGRESS_TRACKER.json spec, and a final verification checklist. Verified that templates.md, template-versioning.md, and save_plan.sh all exist in the bundle.

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints and feedback loops: Step 1 validates configured paths ('Validate that all paths exist on disk... warn the user'), Step 2 handles script failure ('If the script fails (non-zero exit code), report the error output... Do not proceed to Step 3 until the project structure is successfully created'), edge cases are enumerated (multiple/zero PLAN_PREVIEW files, legacy fallback), and Step 6 closes with a completion checklist. This matches the anchor-5 example pattern of validate -> fix -> retry with checklists.

5 / 5

Progressive Disclosure

The SKILL.md body is an operational overview that defers bulk material to real, clearly signaled, one-level-deep bundle files: templates ('using the template from ${CLAUDE_PLUGIN_ROOT}/skills/arn-code-save-plan/references/templates.md'), the version-check procedure ('Read .../references/template-versioning.md for the full template version check procedure'), and the setup script. File listing confirms all three referenced paths exist (templates.md 312 lines, template-versioning.md 57 lines, save_plan.sh 121 lines); the only external pointer (arn-code-ensure-config's preferences-schema.md) is a cross-skill plugin reference, not a nested chain.

5 / 5

Total

19

/

20

Passed

Description

86%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.

A strong description with explicit and extensive trigger guidance covering both 'what' and 'when'. Its main weakness is that the capability statement is compressed to a single action, omitting the concrete artifacts the skill produces, and a few generic scaffolding trigger phrases slightly raise conflict risk.

Suggestions

Enumerate the concrete outputs in the description (e.g., 'creates INTRODUCTION.md, per-phase implementation/testing plans, TASKS.md, and a PROGRESS_TRACKER.json') to lift specificity from one compressed action to comprehensive coverage.

Drop or narrow the generic scaffolding phrases ("set up project structure", "generate project structure", "turn this into a project") that overlap with generic project-scaffolding skills, keeping triggers tied to planning conversations and plan artifacts.

Consider mentioning the Arness prerequisite (that /arn-planning must have configured the project) so the skill is less likely to trigger outside an Arness-configured project.

DimensionReasoningScore

Specificity

The description names the domain and one core action — 'convert a planning conversation into an actionable phased project structure with implementation and testing plans' — but does not enumerate the concrete artifacts it creates (INTRODUCTION.md, phase plans, TASKS.md, PROGRESS_TRACKER.json). It matches the anchor 'names domain and 1-2 concrete actions, but not comprehensive'; it is not a 4 because it never lists several specific actions.

3 / 5

Completeness

It explicitly answers both questions: what ('convert a planning conversation into an actionable phased project structure with implementation and testing plans') and when ('This skill should be used when the user says [12 concrete trigger phrases]... or wants to convert a planning conversation into...'). The explicit trigger-phrase list matches the anchor-5 example structure; not a 4 because 'when' is fully explicit, not just present.

5 / 5

Trigger Term Quality

Comprehensive coverage of natural user phrases with synonyms: "save plan", "save the plan", "export plan", "export project plan", "organize this plan", "structure this plan", "finalize the plan", "turn this into a project". These are exactly what a user would naturally say, matching the top anchor including synonyms.

5 / 5

Distinctiveness Conflict Risk

The core niche (planning-conversation-to-phased-project conversion) is distinct and anchored by Arness-specific triggers like "arness code save plan" and "export plan". However, generic phrases such as "set up project structure", "generate project structure", and "turn this into a project" carry overlap risk with generic scaffolding skills — minor overlap, matching anchor 4 rather than the minimal-conflict anchor 5.

4 / 5

Total

17

/

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-save-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.