CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

66

Quality

79%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./plugins/arn-code/skills/arn-code-save-plan/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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-structured, highly actionable skill with clear multi-step workflow and validation checkpoints. Its main weakness is length — the document packs substantial detail into a single file where some subsections (sketch artifact detection, legacy migration, template versioning) could be offloaded to reference files. The actionability and workflow clarity are excellent, with concrete commands, decision trees, and explicit error handling throughout.

Suggestions

Move the detailed sketch artifact detection logic and legacy migration procedure into separate reference files to reduce the main SKILL.md length and improve progressive disclosure.

Tighten the INTRODUCTION.md section by removing some of the explanatory prose around phase identification heuristics — Claude can infer grouping strategies from a shorter description.

DimensionReasoningScore

Conciseness

The skill is quite lengthy (~200+ lines) with significant detail, some of which could be tightened. The legacy migration flow, sketch artifact detection, and template versioning explanations add bulk. However, most content is genuinely instructional rather than explaining concepts Claude already knows. Some sections like the INTRODUCTION.md population table are efficient, but the overall document could be more concise.

2 / 3

Actionability

The skill provides highly concrete, executable guidance throughout: specific bash commands with variable placeholders, exact file paths, precise file naming patterns (PLAN_PREVIEW_*.md), structured output formats, and detailed decision trees for each conditional branch. The INTRODUCTION.md section mapping table and PROGRESS_TRACKER.json schema are particularly actionable.

3 / 3

Workflow Clarity

The 6-step workflow is clearly sequenced with explicit validation checkpoints: Step 1 validates paths exist on disk, Step 2 checks script exit codes before proceeding, Step 6 provides a verification checklist. Error recovery is addressed (script failure handling, missing config guidance, multiple file disambiguation). The dependency chain between steps is clear and each step has explicit preconditions.

3 / 3

Progressive Disclosure

The skill references external files appropriately (template-versioning.md, templates.md, preferences-schema.md) but the main SKILL.md itself is quite long and monolithic. Some content like the detailed INTRODUCTION.md population logic, sketch artifact detection procedure, and legacy migration flow could potentially be split into reference files. However, no bundle files were provided to verify the referenced paths exist, and the references that do exist are well-signaled.

2 / 3

Total

10

/

12

Passed

Description

82%

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 providing explicit trigger phrases and clearly stating when the skill should be used, earning strong marks for completeness and trigger term quality. However, it is weaker on specificity—it describes the output at a high level ('actionable phased project structure') without detailing the concrete actions or artifacts produced. The distinctiveness is moderate, as some trigger phrases could overlap with project scaffolding or initialization skills.

Suggestions

Add more specific concrete actions describing what the skill produces, e.g., 'Creates phased markdown plans with task breakdowns, generates directory structures, and outputs implementation checklists.'

Differentiate from project scaffolding/initialization skills by clarifying that this skill specifically transforms conversational planning context into structured plans, not code templates or boilerplate.

DimensionReasoningScore

Specificity

The description mentions converting a planning conversation into 'an actionable phased project structure with implementation and testing plans,' which names the domain and a general action, but doesn't list multiple specific concrete actions (e.g., what files are created, what format is used, what the output looks like).

2 / 3

Completeness

The description explicitly answers both 'what' (convert a planning conversation into an actionable phased project structure with implementation and testing plans) and 'when' (with a comprehensive list of trigger phrases and a general condition clause). The 'when' is very explicit.

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would actually say, such as 'save plan', 'create project from plan', 'export plan', 'set up project structure', 'turn this into a project', and 'generate project structure'. These cover many natural variations.

3 / 3

Distinctiveness Conflict Risk

While the trigger phrases are fairly specific to plan-saving/exporting, terms like 'set up project structure' and 'generate project structure' could overlap with scaffolding or project initialization skills. The niche of converting planning conversations is somewhat distinct but not fully delineated from general project creation skills.

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.