CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-code-feature-spec

This skill should be used when the user says "feature spec", "arness code feature spec", "arn-code-feature-spec", "spec this feature", "help me spec", "design this feature", "feature design", "write a spec", "create a specification", "I have an idea for a feature", "let's flesh out this feature", "decompose feature", "spec XL feature", "resume spec", "continue spec", "finish my spec", "break down feature", or wants to iteratively develop a feature idea into a well-formed specification through guided conversation with architectural analysis. For XL features with decomposition hints, creates multiple sub-feature specs with full traceability. Produces specification documents capturing WHAT to build and WHY, which then feed into plan creation.

59

Quality

68%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/arn-code/skills/arn-code-feature-spec/SKILL.md
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 is a strong description with excellent trigger term coverage and clear completeness, explicitly stating both what the skill does and when to use it. The main weakness is that the capability description could be more specific about concrete actions (e.g., what architectural analysis entails, what the specification documents contain beyond WHAT and WHY). The extensive trigger term list is a notable strength but makes the description somewhat front-heavy and harder to parse quickly.

Suggestions

Consider restructuring to lead with concrete capabilities first, then follow with the 'Use when...' trigger list, rather than front-loading all trigger terms before explaining what the skill actually does.

Add more specific concrete actions beyond 'guided conversation with architectural analysis' - e.g., 'identifies dependencies, defines acceptance criteria, maps technical constraints, outlines user stories'.

DimensionReasoningScore

Specificity

The description mentions some concrete actions like 'creates multiple sub-feature specs with full traceability' and 'produces specification documents capturing WHAT to build and WHY', but the core capability description is somewhat vague - 'iteratively develop a feature idea into a well-formed specification through guided conversation with architectural analysis' is more process-oriented than listing specific concrete actions.

2 / 3

Completeness

The description clearly answers both WHAT (iteratively develops feature ideas into well-formed specifications, creates sub-feature specs for XL features, produces specification documents capturing WHAT to build and WHY) and WHEN (extensive explicit trigger list at the beginning with 'This skill should be used when...'). Both dimensions are explicitly addressed.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms including many variations users would actually say: 'feature spec', 'spec this feature', 'help me spec', 'design this feature', 'write a spec', 'create a specification', 'I have an idea for a feature', 'let's flesh out this feature', 'decompose feature', 'resume spec', 'continue spec', 'finish my spec', 'break down feature'. This is comprehensive and covers natural language variations well.

3 / 3

Distinctiveness Conflict Risk

The skill occupies a clear niche around feature specification creation and decomposition, distinct from general coding, planning, or documentation skills. The specific trigger terms like 'feature spec', 'spec this feature', and the mention of XL feature decomposition and traceability make it unlikely to conflict with other skills. The description also clarifies its position in a workflow ('which then feed into plan creation').

3 / 3

Total

11

/

12

Passed

Implementation

47%

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

This is a comprehensive and well-structured workflow with excellent sequencing, error handling, and conditional logic for multiple feature paths (greenfield, XL decomposition, standard). However, it is severely over-verbose for a skill file — the inline content is roughly 5-10x longer than necessary, with extensive repetition of agent context-passing instructions and conditional details that should be pushed into reference files. The progressive disclosure structure exists but is underutilized, with the main file retaining far too much detail.

Suggestions

Move the detailed agent invocation context (what to pass to arn-code-architect, arn-code-ux-specialist, arn-code-security-specialist) into a reference file like agent-context-templates.md, and reference it from the main skill with a one-line pointer per agent.

Extract the Draft Update Protocol, sketch integration details, and scope boundary awareness rules into separate reference files, keeping only 1-2 sentence summaries inline with links to the full procedures.

Compress repeated conditional patterns (e.g., 'if greenfield context loaded' appears 10+ times) into a single decision matrix table at the top of the workflow, then reference it by name rather than re-explaining the conditions each time.

Remove explanatory prose that describes rationale (e.g., 'This prevents scope creep by ensuring the agent knows what sibling features already handle') — Claude doesn't need motivation, just instructions.

DimensionReasoningScore

Conciseness

This skill is extremely verbose at ~400+ lines with extensive conditional branching, repeated context-passing instructions, and detailed edge case handling that could be dramatically compressed. Many sections explain orchestration logic that could be captured in referenced files rather than inline, and there is significant repetition (e.g., context passing instructions for agents are repeated across multiple steps).

1 / 3

Actionability

The skill provides concrete file paths, specific agent invocation patterns, and clear decision trees, but lacks executable code examples. Much of the guidance is procedural description rather than copy-paste ready commands or templates. The actual spec template and agent invocation guide are deferred to reference files that aren't provided, making the inline content more descriptive than executable.

2 / 3

Workflow Clarity

The multi-step workflow is exceptionally well-sequenced with clear step numbering (0 through 5), explicit conditional branching (greenfield vs standard, XL vs single, UI vs no-UI), validation checkpoints (draft saves, resume detection, error recovery), and feedback loops (exploration iteration with draft update protocol, false-negative follow-ups for security and UI agents).

3 / 3

Progressive Disclosure

The skill references several external files (greenfield-loading.md, xl-decomposition.md, agent-invocation-guide.md, feature-spec-template.md, specialist-pre-check.md, step-0-fast-path.md) which is good progressive disclosure structure, but the main SKILL.md itself is a monolithic wall of text with enormous inline detail that should be pushed into those reference files. The balance is wrong — too much is inline and the references handle too little of the complexity.

2 / 3

Total

8

/

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.