CtrlK
BlogDocsLog inGet started
Tessl Logo

testland/bdd-step-library-curator

Keeps a BDD step-definition library DRY across a Cucumber / Behave / Reqnroll project - inventories every step definition, detects duplicates (different patterns matching the same intent), recommends canonical consolidations, reorganizes steps by domain, and publishes a step-library README the team greps for "is there already a step for X?" before authoring new ones. Use when a BDD project's step count grows past ~50, on a quarterly step-library review, or when a new engineer cannot find an existing step and is about to write a duplicate.

75

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

Quality

Content

85%

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

A well-structured instructional skill: clear six-step workflow with a destructive-operation feedback loop, concrete templates, and a clean one-level reference. The only weakness is conciseness — the worked example and intro restate material already covered.

Suggestions

Trim or fold the 'Worked example' section: it re-narrates Steps 1-5 already detailed above — condense to a brief '142 -> 139 steps, zero ambiguous duplicates' outcome summary with a pointer, or drop it.

Shorten the 'Overview' motivational paragraph ('After 6 months of a BDD project, step definitions proliferate...') to one or two lines; the 'When to use' section already conveys the same motivation more crisply.

Consider collapsing the large in-body README template in Step 4 (the multi-line Auth/Navigation/Cart sample) into a shorter skeleton with a pointer to the reference, to reduce the body's token footprint.

DimensionReasoningScore

Conciseness

Mostly efficient and example-driven, but the motivational intro ('After 6 months of a BDD project, step definitions proliferate...') and the full 'Worked example' section re-walk the same Steps 1-5 already detailed above, adding length that could be tightened; not 1 because the content is actionable rather than explaining basics Claude knows, and not 3 due to the redundant worked example and introductory padding.

2 / 3

Actionability

Gives concrete, specific guidance — duplicate detection rules ('Same wording, different phrasing'), a normalization procedure (lowercase, drop articles, collapse parameters), copy-paste-ready templates for the duplicate-group table, directory tree, and README index; per the scoring notes, an instruction-only skill is not penalized for offloading executable code to the reference, so this clears the 3 anchor over the incomplete-guidance 2.

3 / 3

Workflow Clarity

Steps 1-6 are clearly sequenced and the destructive consolidation step has an explicit feedback loop: 'run the full BDD suite and assert zero undefined or ambiguous steps... If a scenario reports an undefined step... fix that reference and re-run', matching the score-3 anchor with validation and error recovery; not 2 because checkpoints are explicit rather than implicit.

3 / 3

Progressive Disclosure

The body is an overview that signals a single one-level-deep reference (references/step-extraction-and-overlap.md, verified to exist) for the deep extraction commands, overlap script, and pre-merge gate, matching the score-3 anchor; not 2 because the split is clean and well-signaled rather than inline-heavy or nested.

3 / 3

Total

11

/

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.

A strong description: third-person voice, concrete action list, explicit 'Use when' triggers, and a distinct niche. It earns top marks across all four dimensions with no first/second-person or over-claim issues.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'inventories every step definition', 'detects duplicates', 'recommends canonical consolidations', 'reorganizes steps by domain', 'publishes a step-library README' — matching the score-3 anchor for multiple specific concrete actions; it is above 2 because the action list is comprehensive rather than naming only a few.

3 / 3

Completeness

Explicitly answers both what (inventories/detects/recommends/reorganizes/publishes) and when via an explicit 'Use when...' clause with concrete triggers, matching the score-3 anchor; not 2 because the when guidance is explicit rather than implied.

3 / 3

Trigger Term Quality

Covers natural terms the audience would say — 'BDD', 'step count grows past ~50', 'quarterly step-library review', 'new engineer cannot find an existing step', and the literal team phrase 'is there already a step for X?' — giving good coverage rather than the partial coverage at 2.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche — DRY curation of a BDD step-definition library across Cucumber/Behave/Reqnroll — with distinct triggers unlikely to fire for unrelated skills, matching the score-3 anchor; it is not 2 because the scope is tightly scoped rather than broadly overlapping.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Reviewed

Table of Contents