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.

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

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

DimensionReasoningScore

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.

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.