CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-spark-use-cases

This skill should be used when the user says "use cases", "arn use cases", "write use cases", "define use cases", "Cockburn use cases", "actor goals", "behavioral requirements", "system behavior", "what does the app do", "describe the behavior", "use case document", "document the behavior", "define system behavior", or wants to create structured use case documents that describe the application's behavior from actor perspectives, producing a use-cases/ directory with individual Cockburn fully-dressed use case files and a README index.

74

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-spark/skills/arn-spark-use-cases/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 description excels at trigger term coverage and completeness, providing an extensive list of natural phrases that would help Claude select this skill appropriately. It clearly defines both when to use it and what it produces. The main weakness is that the specificity of concrete actions could be improved — it focuses more on trigger phrases and output artifacts than on the specific steps or capabilities involved in creating the use cases.

Suggestions

Add more specific concrete actions beyond just the output, e.g., 'Identifies actors and their goals, defines preconditions and postconditions, maps main success scenarios and extensions, documents stakeholders and interests'.

DimensionReasoningScore

Specificity

The description names the domain (use case documents, Cockburn fully-dressed format) and mentions some outputs (use-cases/ directory, individual files, README index), but the concrete actions are limited — it mostly describes what it produces rather than listing multiple distinct actions like 'analyze actor goals, define preconditions, map success/failure scenarios'.

2 / 3

Completeness

The description explicitly answers both 'what' (creates structured use case documents describing application behavior from actor perspectives, producing a use-cases/ directory with Cockburn fully-dressed use case files and a README index) and 'when' (with an explicit list of trigger phrases and conditions). The 'Use when' guidance is embedded via 'This skill should be used when...'.

3 / 3

Trigger Term Quality

The description includes an extensive list of natural trigger phrases users would say: 'use cases', 'write use cases', 'define use cases', 'Cockburn use cases', 'actor goals', 'behavioral requirements', 'system behavior', 'what does the app do', 'describe the behavior', 'use case document', etc. This provides excellent coverage of natural language variations.

3 / 3

Distinctiveness Conflict Risk

The description is highly specific to Cockburn fully-dressed use cases with a distinct output format (use-cases/ directory structure). The niche of behavioral requirements documentation in Cockburn format is unlikely to conflict with other skills like general documentation, requirements gathering, or user story writing.

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 skill defines a comprehensive, well-structured multi-step workflow for creating Cockburn fully-dressed use cases with expert agent collaboration. Its greatest strength is workflow clarity — the 8-step process has clear sequencing, convergence criteria, and user checkpoints. However, it is severely over-long, explaining concepts Claude already knows (actor types, use case levels, relationship types) and duplicating workflow content in the agent invocation guide. The error handling section, while thorough, adds significant token cost for edge cases Claude could reason about independently.

Suggestions

Cut the conciseness bloat: Remove explanations of Cockburn concepts (actor types, use case levels, includes/extends) that Claude already knows. Reduce the skill by ~40% by trusting Claude's domain knowledge.

Move the Agent Invocation Guide and Error Handling sections to separate reference files (e.g., references/agent-guide.md and references/error-handling.md) to improve progressive disclosure and reduce the main skill's token footprint.

Consolidate the duplicate content between the workflow steps and the Agent Invocation Guide table — the table largely restates what Steps 2-7 already describe.

Trim the error handling to only non-obvious cases (e.g., keep 'resume with corrupted files' but remove 'no actors identified' which Claude can handle with basic reasoning).

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines. It over-explains concepts Claude already understands (what actors are, what use case levels mean, what includes/extends relationships are). The agent invocation guide largely duplicates the workflow steps. The error handling section lists 17 edge cases, many of which Claude could handle with general reasoning. Significant token waste throughout.

1 / 3

Actionability

The skill provides concrete step-by-step workflows with specific agent names, file paths, and template references. However, there is no executable code — it relies on agent invocations with natural language instructions rather than concrete commands or scripts. The agent invocation prompts are detailed but are prose descriptions rather than copy-paste-ready invocations. The table formats and presentation templates are helpful but still somewhat abstract.

2 / 3

Workflow Clarity

The 8-step workflow is clearly sequenced with explicit validation checkpoints: Step 1 handles resume/fresh start detection, Step 6b has explicit convergence criteria with a maximum of 2 review rounds to prevent infinite loops, Step 7 provides user review with clear options, and feedback conflicts are surfaced to the user before proceeding. The parallel drafting strategy with grouping logic is well-defined.

3 / 3

Progressive Disclosure

The skill references external templates (use-case-template.md, use-case-index-template.md, expert-review-template.md, review-protocol.md) which is good progressive disclosure. However, no bundle files were provided to verify these exist. The main SKILL.md itself is monolithic — the agent invocation guide and error handling sections could be separate reference files. The massive inline content undermines the progressive disclosure principle.

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.