This skill should be used when the user says "feature extract", "arn feature extract", "extract features", "feature backlog", "create backlog", "list features", "what features do we need", "prioritize features", "feature list", "build the backlog", "what should we build", "upload features", "feature tracker", or wants to extract a structured, prioritized feature list with journey steps, validated components, use case context, and UI behavior details from all project artifacts, producing a feature backlog document with a Feature Tracker that bridges into arn-code-feature-spec and optionally uploads features to the issue tracker.
62
73%
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-feature-extract/SKILL.mdQuality
Discovery
100%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 providing explicit trigger terms and clearly defining both what the skill does and when to use it. The extensive list of trigger phrases ensures reliable skill selection, and the specific outputs (feature backlog, Feature Tracker, journey steps) make the capability concrete. However, the description is structured as a single long sentence which hurts readability, and it uses 'This skill should be used when' framing rather than third-person active voice describing capabilities first.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: extract structured/prioritized feature list, produce feature backlog document with Feature Tracker, bridge into arn-code-feature-spec, upload features to issue tracker. Also mentions specific outputs like journey steps, validated components, use case context, and UI behavior details. | 3 / 3 |
Completeness | Clearly answers both 'what' (extract structured prioritized feature list with journey steps, validated components, use case context, UI behavior details, producing a feature backlog document with Feature Tracker) and 'when' (explicit trigger phrases listed at the start with 'This skill should be used when...'). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including many variations users would actually say: 'feature extract', 'extract features', 'feature backlog', 'create backlog', 'list features', 'what features do we need', 'prioritize features', 'what should we build', 'upload features', 'feature tracker'. These are natural, conversational phrases. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: feature extraction and backlog creation from project artifacts, with specific toolchain references (arn-code-feature-spec, Feature Tracker, issue tracker). The domain-specific terminology and explicit trigger phrases make it unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 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 demonstrates excellent workflow design with clear sequencing, validation checkpoints, and comprehensive error handling, but suffers severely from verbosity. The content is roughly 5-10x longer than necessary — it repeats agent invocation patterns, over-explains artifact relationships Claude could infer, and inlines massive error handling and artifact scanning details that belong in reference files. The actionability is moderate: the workflow is clear but lacks concrete executable examples for tool calls and file writing.
Suggestions
Reduce the skill body to ~150-200 lines by moving artifact scanning details, error handling, and the agent invocation guide into separate reference files (e.g., `references/artifact-sources.md`, `references/error-handling.md`)
Remove redundant explanations — the model parameter dispatch convention is repeated 4 times identically; state it once and reference it. Similarly, consolidate the repeated 'invoke agent via Task tool' pattern into a single convention statement.
Add concrete executable examples for key operations: show the actual Task tool invocation syntax, a complete feature file write example, and the issue creation command with a fully populated body template
Eliminate explanatory content Claude doesn't need, such as 'Each user-goal use case maps to one or more features. Extensions reveal edge-case features. Postconditions provide acceptance criteria. Business rules become feature constraints.' — Claude understands use case structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This skill is extremely verbose at ~500+ lines. It exhaustively lists every possible artifact path, every error case, every agent invocation pattern, and repeats information multiple times (e.g., the model parameter dispatch convention is mentioned identically 4 times). Much of this detail could be condensed or moved to reference files. Claude doesn't need explanations like 'settings panel implies settings feature, dark mode toggle implies theme feature' or lengthy descriptions of what use cases contain. | 1 / 3 |
Actionability | The skill provides a clear multi-step workflow with specific file paths, tool invocations, and output formats. However, it lacks executable code examples — the only code snippet is a single `gh issue create` command. The agent invocation instructions are described in prose rather than showing concrete tool call syntax. The feature presentation format is well-specified with examples, which helps, but much of the guidance is descriptive rather than directly executable. | 2 / 3 |
Workflow Clarity | The workflow is exceptionally well-sequenced with 8 clearly numbered steps, explicit validation checkpoints (Step 2b gap resolution, Step 5 sizing validation), feedback loops (Step 4 interactive refinement with a comprehensive action table), and clear decision points (e.g., 'If no gaps found: skip to Step 3'). Error recovery is thoroughly addressed. The gap resolution step includes a structured table of gap types with signals. | 3 / 3 |
Progressive Disclosure | The skill references external templates (`feature-entry-template.md`, `feature-backlog-template.md`, `platform-labels.md`, `ensure-config.md`) which is good progressive disclosure. However, the SKILL.md itself is a monolithic wall of text that inlines enormous amounts of detail that could be in reference files — the error handling section alone is ~40 items, the agent invocation guide repeats workflow information, and artifact loading details could be a separate reference. No bundle files were provided to verify reference accuracy. | 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.