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.
59
68%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/arn-spark/skills/arn-spark-use-cases/SKILL.mdQuality
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. Its main weakness is that the specificity of concrete actions could be improved — it focuses more on listing trigger phrases and describing the output format than enumerating the specific analytical steps or capabilities involved. The extensive trigger phrase list, while helpful for matching, makes the description somewhat verbose.
Suggestions
Add more specific concrete actions beyond output description, e.g., 'Identifies actors and goals, defines preconditions and postconditions, maps main success scenarios and extensions, documents stakeholders and interests'.
| Dimension | Reasoning | Score |
|---|---|---|
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 distinctive with its focus on Cockburn fully-dressed use cases, actor perspectives, and the specific output structure (use-cases/ directory with README index). This is a clear niche that is unlikely to conflict with other documentation or requirements skills. | 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 has excellent workflow clarity with well-defined steps, convergence criteria, and error recovery paths, making it strong for guiding a complex multi-agent process. However, it is extremely verbose — explaining actor types, use case levels, and relationship types that Claude already knows, and duplicating workflow content in the agent invocation guide. The monolithic structure with inline error handling and dispatch tables undermines progressive disclosure despite good use of external template references.
Suggestions
Cut explanatory content Claude already knows: remove definitions of primary/secondary/supporting actors, use case levels (summary/user-goal/subfunction), and includes/extends relationships — just reference the terms directly.
Move the Agent Invocation Guide and Error Handling sections into separate reference files (e.g., references/agent-dispatch.md and references/error-handling.md) to reduce the main skill to its core workflow.
Eliminate duplication between the workflow steps and the agent invocation guide — the guide repeats nearly everything from Steps 2-7 in table form.
Tighten Step 2a by removing the bulleted explanations of actor types and use case levels, keeping only the extraction instructions and output format.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~400+ lines. Extensively 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 is exhaustive to the point of over-engineering, covering edge cases that Claude could handle with general reasoning. Many sections could be cut by 50-70% without losing actionable information. | 1 / 3 |
Actionability | The workflow steps are reasonably concrete with specific agent names, file paths, and template references. However, there is no executable code — it's all procedural prose. The agent invocation instructions are specific but rely on external templates and references that aren't provided in the bundle, making it hard to verify completeness. The skill is instruction-only, so lack of code isn't penalized, but some steps remain vague (e.g., 'perform an initial extraction' without specifying the exact output format). | 2 / 3 |
Workflow Clarity | The 8-step workflow is clearly sequenced with explicit validation checkpoints (convergence check in Step 6b with specific criteria, user review in Step 7, resume detection in Step 1). Feedback loops are well-defined: review → conflict resolution → revision → convergence check → possible second round with a hard cap at 2 rounds. Error recovery paths are thorough. | 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, ensure-config.md) which suggests good structural intent, but no bundle files were provided to verify these exist. The SKILL.md itself is monolithic — the agent invocation guide and error handling sections are large inline blocks that could be separate reference files. The content would benefit from splitting the detailed error handling and agent dispatch table into referenced files. | 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
b9084b6
Table of Contents
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.