CtrlK
BlogDocsLog inGet started
Tessl Logo

013-agile-feature

Guides the creation of detailed agile feature documentation from an existing epic. Use when the user wants to split an epic into feature files, derive features with scope and acceptance criteria, or plan feature documentation for stakeholders or engineering. This should trigger for requests such as Create features from an epic; Split epic into features; Feature files from epic; Derive features from epic. Part of cursor-rules-java project

59

Quality

67%

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

Quality

Content

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill provides a reasonable high-level structure for an interactive epic-to-features workflow, but critically lacks the concrete content needed to execute it. The template questions and feature document template—the core actionable elements—are entirely absent from the SKILL.md body and deferred to a reference file that isn't available. The workflow is sequenced but missing validation/review checkpoints after document generation.

Suggestions

Include the actual numbered template questions (1-11) inline or at minimum show 2-3 examples so the skill is actionable without the reference file

Add the feature document Markdown template directly in the skill or show a concrete example of a generated feature file

Add a validation/review step after document generation (e.g., 'Present generated feature summary to user for approval before writing file')

Remove the 'What is covered in this Skill?' bullet list as it duplicates the workflow and constraints sections

DimensionReasoningScore

Conciseness

The content is mostly efficient but includes some unnecessary repetition (constraints are restated in the workflow section) and meta-commentary like 'What is covered in this Skill?' that could be trimmed. The bullet list of coverage areas largely duplicates the workflow and constraints sections.

2 / 3

Actionability

The skill lacks concrete, executable guidance. There are no actual template questions shown (it says 'use exact wording from the numbered template questions' but never provides them), no example feature document output, and no concrete examples of naming conventions or file structures. The core actionable content is deferred entirely to a reference file that isn't provided.

1 / 3

Workflow Clarity

The workflow has a clear sequence (get date → analyze epic → generate documents → close with guidance), but lacks validation checkpoints. There's no verification step after generating feature files, no feedback loop for reviewing generated documents with the user, and the per-feature refinement loop (questions 9-11) is mentioned but not shown concretely.

2 / 3

Progressive Disclosure

The skill references a detailed guide at 'references/013-agile-feature.md' which is appropriate one-level-deep disclosure, but since no bundle files are provided, we cannot verify the reference exists or is well-structured. The main problem is that too much critical content (the actual template questions, the feature document template) appears to live entirely in the reference file, leaving the SKILL.md too hollow to be useful on its own.

2 / 3

Total

7

/

12

Passed

Description

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 is a well-crafted skill description that clearly communicates its purpose, provides explicit trigger guidance with multiple natural phrasings, and occupies a distinct niche in agile feature documentation from epics. The description is concise yet comprehensive, covering what the skill does, when to use it, and specific trigger phrases. The only minor note is the trailing 'Part of cursor-rules-java project' which adds context but doesn't significantly aid skill selection.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions: 'split an epic into feature files', 'derive features with scope and acceptance criteria', 'plan feature documentation for stakeholders or engineering'. These are clear, actionable capabilities.

3 / 3

Completeness

Clearly answers both 'what' (guides creation of detailed agile feature documentation from an existing epic, with scope and acceptance criteria) and 'when' (explicit 'Use when' clause plus a 'This should trigger for' clause listing specific request patterns).

3 / 3

Trigger Term Quality

Includes strong natural trigger terms that users would actually say: 'split epic into features', 'feature files from epic', 'derive features from epic', 'create features from an epic', 'acceptance criteria', 'feature documentation'. Good coverage of natural variations.

3 / 3

Distinctiveness Conflict Risk

The description carves out a clear niche: specifically about deriving features from epics in an agile context. The combination of 'epic', 'feature files', 'acceptance criteria', and the agile documentation focus makes it highly distinct and unlikely to conflict with other skills.

3 / 3

Total

12

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/cursor-rules-java
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.