CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bdd-testing

Write and maintain Behavior-Driven Development tests with Gherkin and Cucumber. Use when defining acceptance scenarios, writing feature files, implementing step definitions, running Three Amigos sessions, or diagnosing BDD test quality issues. Keywords: bdd, gherkin, cucumber, given when then, feature files, step definitions, acceptance criteria, three amigos, example mapping.

Quality

95%

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

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

The skill body is a strong example of the format: a validated multi-step workflow with error-recovery loops, executable Cucumber commands with expected results, and impactful BAD/GOOD anti-patterns. The main weakness is reference hygiene — two bundle files are orphaned from the References section and some cross-links inside reference files point to files that do not exist.

Suggestions

Annotate each entry in the References section with a one-line description of what it covers (e.g. 'principles-three-amigos.md — roles and cadence of the three-perspective discussion') so the right file can be chosen without opening all of them.

Add the two missing bundle files (principles-living-documentation.md and principles-ubiquitous-language.md) to the References section — they currently exist in the bundle but are undiscoverable from SKILL.md.

Remove or fix the @see cross-references inside reference files that point to nonexistent files (e.g. collaboration-example-mapping-workshop.md, patterns-domain-language.md), since they break navigation one level deeper.

DimensionReasoningScore

Conciseness

The body is efficient — commands with one-line expected results, terse BAD/GOOD contrasts, no concept tutorials — but includes minor over-explanation Claude doesn't need, e.g. "Steps that don't wait for async operations will complete before actions finish" and "Implementation-centric steps break when internals change". This fits the score-4 anchor ('minor instances of over-explanation that could be trimmed'); it is above level 3 because the padding is incidental, not sectional.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready: concrete commands with flags ("npx cucumber-js --tags \"@smoke and not @wip\"", "npx cucumber-js --format json:reports/cucumber-report.json"), expected results for each, and concrete Gherkin examples ("GOOD: `When I submit the form`"). This matches the score-5 anchor covering common cases.

5 / 5

Workflow Clarity

The Deterministic Workflow is a clear 5-step sequence with explicit labeled checkpoints and feedback loops: "Validation checkpoint: If scenarios fail due to incorrect business logic, loop back to step 2" and "Error recovery: Run `npx cucumber-js --dry-run`", exactly matching the score-5 anchor pattern (validate, fix, retry, only-then-proceed).

5 / 5

Progressive Disclosure

The body is well structured with a References section of real, one-level-deep files, fitting the score-4 anchor. It falls short of 5 because the reference paths are listed bare without per-file descriptions, two bundle files (principles-living-documentation.md, principles-ubiquitous-language.md) are absent from the list and thus undiscoverable, and reference files contain @see links to nonexistent files (e.g. collaboration-example-mapping-workshop.md) — more than 'minor organization gaps' for anchor 5.

4 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

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 strong description: third-person voice, concrete action verbs, an explicit 'Use when' trigger clause, and an unusually thorough keyword list with synonyms. It matches the structure of the rubric's good examples and shows no vague fluff or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "defining acceptance scenarios, writing feature files, implementing step definitions, running Three Amigos sessions, or diagnosing BDD test quality issues" — covering the domain comprehensively, matching the score-5 anchor. It is not a level 4 case because coverage extends beyond 'several' actions to the full lifecycle (write, maintain, diagnose).

5 / 5

Completeness

It explicitly answers both what ("Write and maintain Behavior-Driven Development tests with Gherkin and Cucumber") and when ("Use when defining acceptance scenarios... or diagnosing BDD test quality issues") with concrete trigger phrases, exactly matching the score-5 anchor example structure. A level 4 would require the 'when' clause to be less explicit.

5 / 5

Trigger Term Quality

The keyword list is comprehensive and natural: "bdd, gherkin, cucumber, given when then, feature files, step definitions, acceptance criteria, three amigos, example mapping" — including synonyms ("given when then", "three amigos", "example mapping") users would actually say. It clearly exceeds the score-4 anchor ('a few natural terms missing').

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (BDD/Gherkin/Cucumber) with distinct triggers ("three amigos", "example mapping", "gherkin") that no general testing or documentation skill would claim, matching the score-5 anchor. There is minor conceptual overlap with generic testing skills, but not enough to drop to level 4.

5 / 5

Total

20

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

pantheon-org/tekhne

Path

skills/testing/bdd-testing/SKILL.md

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.