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
78%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/012-agile-epic/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 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.
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
a886986
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.