CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

73

Quality

90%

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

81%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.

A well-structured skill body: an explicit workflow with real validation and error-recovery loops, executable commands with expected results, and disciplined BAD/GOOD anti-pattern examples. The main gaps are the missing step-definition code example and incomplete signaling of the bundle's reference files.

Suggestions

Add a short step-definition example (a Gherkin step plus its matching JavaScript glue) under the workflow's step 3 to make the implementation guidance executable rather than directional.

Reference all seven files in `references/` from the body — `principles-living-documentation.md` and `principles-ubiquitous-language.md` are currently undiscoverable — ideally with a one-phrase description of each so the right file can be chosen without opening them.

Remove or trim the 'Evaluate this skill quality' meta section and the explanatory sentence about async steps to reclaim tokens without losing guidance.

DimensionReasoningScore

Conciseness

The body is largely lean — commands with one-line expected results, no re-explanation of what Gherkin or Cucumber are — but a few tokens could be trimmed: the "Evaluate this skill quality" section is meta-content that does not help the skill's user, and the async-timing troubleshooting line spells out behavior Claude can infer ("Steps that don't wait for async operations will complete before actions finish"). Not a 5 because these minor padded spots exist; not a 3 because there is no concept-teaching and every section carries operational value.

4 / 5

Actionability

Five copy-paste-ready `npx cucumber-js` commands with expected results, plus concrete BAD/GOOD Gherkin step examples, cover running and diagnosing fully. Not a 5 because step-definition implementation — one of the skill's core tasks — gets only the abstract directive "Implement step definitions that map to business language" with no code snippet or pointer to a specific example in the references.

4 / 5

Workflow Clarity

The five-step workflow has explicit validation checkpoints ("If scenarios fail due to incorrect business logic, loop back to step 2") and error-recovery actions with a concrete command (`npx cucumber-js --dry-run` to find missing steps) — a genuine feedback loop matching the top anchor. Not a 4 because both failure modes are distinguished and each is routed to a corrective step with a verification command.

5 / 5

Progressive Disclosure

The body stays a concise overview, and five of the seven files in `references/` are listed one level deep in a References section (all listed paths exist on disk). Not a 5 because two bundle files (`principles-living-documentation.md`, `principles-ubiquitous-language.md`) are never signaled in the body and would only be found by directory listing, and the references are bare paths with no hint of what each covers.

4 / 5

Total

17

/

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.

An exemplary description: concrete capabilities, an explicit 'Use when' clause with enumerated triggers, and a comprehensive natural-language keyword list. Third-person voice throughout, concise, and clearly distinguishable from neighboring testing skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Write and maintain Behavior-Driven Development tests", "defining acceptance scenarios, writing feature files, implementing step definitions, running Three Amigos sessions, or diagnosing BDD test quality issues" — covering the skill's capabilities comprehensively with no vague filler. Not a 4 because there are no coverage gaps: authoring, implementing, running, and diagnosing are all named.

5 / 5

Completeness

It explicitly answers both questions: what ("Write and maintain BDD tests with Gherkin and Cucumber") and when ("Use when defining acceptance scenarios, writing feature files, implementing step definitions, running Three Amigos sessions, or diagnosing BDD test quality issues") with concrete trigger phrases. Not a 4 because the 'when' clause is fully explicit and enumerated rather than merely present.

5 / 5

Trigger Term Quality

An explicit keyword list — "bdd, gherkin, cucumber, given when then, feature files, step definitions, acceptance criteria, three amigos, example mapping" — comprehensively covers the natural phrases a user would say, including synonyms and both abbreviations and full terms. Not a 4 because common variations users would actually utter (e.g., "given when then", "acceptance criteria", "example mapping") are all present, not just a few.

5 / 5

Distinctiveness Conflict Risk

The BDD/Gherkin/Cucumber niche is clear with distinct trigger terms ("gherkin", "cucumber", "three amigos", "example mapping") that would not naturally fire for a generic testing or unit-testing skill. Not a 4 because the triggers are tightly scoped to this domain; there is no meaningful overlap with adjacent skills.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pantheon-org/tekhne
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.