CtrlK
BlogDocsLog inGet started
Tessl Logo

012-agile-epic

Guides the creation of agile epics with comprehensive definition including business value, success criteria, and breakdown into user stories. Use when the user wants to create an agile epic, define large bodies of work, break down features into user stories, or document strategic initiatives. Part of the skills-for-java project

83

Quality

78%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/012-agile-epic/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 is a well-crafted skill description that excels across all dimensions. It provides specific capabilities, includes natural trigger terms users would actually say, explicitly addresses both what the skill does and when to use it, and carves out a distinct niche in agile project management. The 'Part of the skills-for-java project' suffix is unnecessary metadata but doesn't significantly detract from the description's quality.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'creation of agile epics', 'comprehensive definition including business value, success criteria', and 'breakdown into user stories'. These are clear, actionable capabilities.

3 / 3

Completeness

Clearly answers both what ('Guides the creation of agile epics with comprehensive definition including business value, success criteria, and breakdown into user stories') AND when ('Use when the user wants to create an agile epic, define large bodies of work, break down features into user stories, or document strategic initiatives').

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'agile epic', 'user stories', 'features', 'strategic initiatives', 'large bodies of work'. These cover common variations of how users might request this functionality.

3 / 3

Distinctiveness Conflict Risk

Clear niche focused specifically on agile epics and user stories with distinct triggers like 'epic', 'user stories', 'strategic initiatives'. Unlikely to conflict with general documentation or other project management skills.

3 / 3

Total

12

/

12

Passed

Implementation

57%

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 overview of epic creation with clear constraints and appropriate progressive disclosure to a reference file. However, it lacks concrete examples, explicit workflow steps, and validation checkpoints that would make it immediately actionable without consulting the reference document.

Suggestions

Add a numbered workflow sequence (1. Get date, 2. Ask questions in order, 3. Validate completeness, 4. Generate document) with explicit validation before document generation

Include at least one concrete example question from the template and a sample output snippet to make the skill immediately actionable

Remove or consolidate the 'When to use this skill' section as these trigger phrases add little value and consume tokens

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some redundancy (e.g., 'What is covered in this Skill?' section largely duplicates what's implied by the title and constraints). The 'When to use this skill' section lists near-identical trigger phrases that add little value.

2 / 3

Actionability

Provides clear constraints and process guidance, but lacks concrete examples of questions to ask, expected outputs, or the actual template format. The actionable content is deferred entirely to the reference file rather than providing a quick-start example.

2 / 3

Workflow Clarity

The workflow is implied (get date → ask questions in order → generate document) but not explicitly sequenced with numbered steps. Missing validation checkpoints for verifying gathered information before document generation.

2 / 3

Progressive Disclosure

Appropriately structures content with a clear overview in the main file and a single, well-signaled reference to detailed guidance. The reference link is one level deep and clearly labeled.

3 / 3

Total

9

/

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.