Guides the creation of agile user stories and Gherkin feature files. Use when the user wants to create a user story, write acceptance criteria, define Gherkin scenarios, or author BDD feature files. Part of the skills-for-java project
70
62%
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/014-agile-user-story/SKILL.mdQuality
Discovery
89%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-structured skill description with explicit 'Use when' triggers and good coverage of natural keywords users would employ. The main weakness is that the capabilities section could be more specific about what concrete actions the skill performs beyond 'guides the creation'. The mention of 'Part of the skills-for-java project' adds context but doesn't enhance skill selection.
Suggestions
Expand the capabilities to list more specific actions, e.g., 'Generates properly formatted user stories with As a/I want/So that structure, writes Given/When/Then acceptance criteria, creates .feature files with scenario outlines'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (agile user stories, Gherkin feature files) and mentions some actions (create, write, define, author), but doesn't list comprehensive concrete actions like specific formatting, validation, or output types. | 2 / 3 |
Completeness | Clearly answers both what ('Guides the creation of agile user stories and Gherkin feature files') and when ('Use when the user wants to create a user story, write acceptance criteria, define Gherkin scenarios, or author BDD feature files') with explicit triggers. | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'user story', 'acceptance criteria', 'Gherkin scenarios', 'BDD feature files'. These cover common variations of how users would request this functionality. | 3 / 3 |
Distinctiveness Conflict Risk | Has a clear niche with distinct triggers (Gherkin, BDD, user stories, acceptance criteria) that are unlikely to conflict with other skills. The domain is specific enough to avoid overlap. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill acts primarily as a pointer to an external reference file rather than providing actionable guidance itself. While it correctly identifies the scope and constraints, it lacks any concrete examples of questions to ask, template formats, or sample outputs. The skill would be unusable without the referenced file, violating the principle that SKILL.md should be a functional overview.
Suggestions
Include at least 2-3 example questions from the template directly in SKILL.md so Claude can begin the workflow without reading the reference file
Add a concrete example of the expected output format (sample user story markdown structure and Gherkin feature file snippet)
Define explicit numbered workflow steps: 1) Ask persona question, 2) Ask goal question, etc., with clear transition points
Remove the 'What is covered' section and integrate that information into actionable guidance
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is relatively brief but includes some unnecessary explanation like 'What is covered in this Skill?' section that could be trimmed. The constraints section is efficient. | 2 / 3 |
Actionability | The skill provides no concrete examples, templates, or executable guidance. It tells Claude to 'ask questions from the template' and 'use exact wording' but doesn't show what those questions or templates look like - all actual content is deferred to a reference file. | 1 / 3 |
Workflow Clarity | The workflow is implied (ask questions → gather info → generate artifacts) with some sequencing in constraints, but lacks explicit steps, validation checkpoints, or clear feedback loops for the interactive process. | 2 / 3 |
Progressive Disclosure | References a single external file appropriately, but the SKILL.md itself is too sparse - it defers almost all actionable content to the reference file rather than providing a usable quick-start overview. | 2 / 3 |
Total | 7 / 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.
7772a1b
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.