CtrlK
BlogDocsLog inGet started
Tessl Logo

014-agile-user-story

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

Quality

62%

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/014-agile-user-story/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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'

DimensionReasoningScore

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

DimensionReasoningScore

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.

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.