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.

73

Quality

92%

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, largely actionable skill body: the workflow includes genuine validation checkpoints and error-recovery loops, and commands carry expected results. Weaknesses are localized — duplicated async/dry-run guidance, a missing step-definition code example, orphaned reference files, and a broken script path.

Suggestions

Consolidate the async-timing guidance into a single occurrence and remove the duplicated dry-run troubleshooting entry that repeats an earlier Quick Command verbatim.

Add a short executable step-definition example (e.g., a JavaScript Cucumber step with async/await) so the 'implement step definitions' workflow step has concrete code like the rest of the skill.

Either reference the two orphaned bundle files (principles-living-documentation.md, principles-ubiquitous-language.md) from the body or remove them; likewise fix or remove the evaluate.sh command pointing to a script not present in this bundle.

DimensionReasoningScore

Conciseness

The body is lean overall with no 'what is BDD' padding, but the async guidance is repeated three times ('Check that step definitions return or await promises. Steps that don't wait for async operations will complete before actions finish' followed by 'Pattern: Ensure `async` functions use `await` for all asynchronous calls'), and the troubleshooting section repeats the exact dry-run command already shown. These are minor, trimmable instances of over-explanation rather than pervasive padding.

4 / 5

Actionability

Five copy-paste-ready bash commands each include expected results, and anti-patterns give concrete BAD/GOOD Gherkin examples. Minor gaps keep it below fully executable: no step-definition code sample despite 'implementing step definitions' being a core workflow step, and the 'Evaluate this skill quality' command references a script path ('skills/agentic-harness/skill-quality-auditor/scripts/evaluate.sh') that does not exist in this bundle.

4 / 5

Workflow Clarity

The 'Deterministic Workflow' is a clear 5-step sequence with explicit validation checkpoints and feedback loops — 'If scenarios fail due to incorrect business logic, loop back to step 2' and 'loop back to step 3 to fix implementation' — plus error recovery via 'npx cucumber-js --dry-run'. This matches the top anchor: explicit validation steps, feedback loops for error recovery.

5 / 5

Progressive Disclosure

The body is a well-organized overview with a one-level-deep References section, and all five cited reference files exist in the bundle. Minor organization gaps: 'principles-living-documentation.md' and 'principles-ubiquitous-language.md' are present but never referenced from the body (orphaned), and one command points to a nonexistent script.

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.

The description is exemplary: concrete capabilities, an explicit 'Use when' clause with specific triggers, comprehensive natural keywords, and a clearly distinct BDD niche. It follows third-person imperative voice with no fluff or over-claims.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'Write and maintain Behavior-Driven Development tests with Gherkin and Cucumber', 'defining acceptance scenarios, writing feature files, implementing step definitions, running Three Amigos sessions, or diagnosing BDD test quality issues' — covering authoring and diagnosis comprehensively with no coverage gaps.

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, writing feature files, implementing step definitions, running Three Amigos sessions, or diagnosing BDD test quality issues') with concrete trigger phrases.

5 / 5

Trigger Term Quality

The keyword list — 'bdd, gherkin, cucumber, given when then, feature files, step definitions, acceptance criteria, three amigos, example mapping' — comprehensively covers the natural terms and synonyms users would say, including the colloquial 'given when then' phrasing.

5 / 5

Distinctiveness Conflict Risk

The BDD/Gherkin/Cucumber niche is clearly defined with tool-specific triggers (cucumber, gherkin, three amigos, example mapping), making conflicts with general testing or TDD skills unlikely.

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.