CtrlK
BlogDocsLog inGet started
Tessl Logo

arn-spark-feature-extract

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

Quality

73%

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-feature-extract/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

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.