CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

gherkin-bdd

Write BDD scenarios in Gherkin. Trigger: acceptance criteria, Given/When/Then, feature files, test scenarios.

Quality

88%

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

92%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 body is a lean, opinionated style guide with executable Gherkin templates, concrete good/bad step examples, an anti-patterns table with fixes, and an explicit coverage workflow with a done-when checklist. Its only trimmable content is the basic Gherkin syntax skeleton that restates what Claude already knows.

DimensionReasoningScore

Conciseness

The Rules and Anti-patterns sections are dense with non-obvious, project-specific judgment ("A UI Then is scored by Jev against the accessibility tree"), but the Structure section's basic Gherkin skeleton (Feature/Background/Given/When/Then) largely restates syntax Claude already knows and could be trimmed. This matches anchor 4's minor instances of over-explanation rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

The body provides complete, copy-adaptable Gherkin templates for both a plain scenario and a Scenario Outline with an Examples table, plus concrete good/bad pairs ("When the customer submits the order" — never "When I click \"#submit-btn\"") and a Fix column in the anti-patterns table. Guidance is fully executable and covers the common cases.

5 / 5

Workflow Clarity

This is not a destructive or batch operation, so no cap applies. The Coverage section defines the process ("Work from the list of use cases and edge cases, not from intuition"), includes an explicit feedback loop ("A case with no scenario is a gap to report, not a case to silently drop"), and ends with a validation checklist ("**Done when** every case maps to at least one scenario, each scenario has exactly one When and an observable Then").

5 / 5

Progressive Disclosure

The skill is self-contained (~50 non-blank lines) with no external references needed, and content is well-organized into clearly navigable sections (Structure, Rules, Anti-patterns, Coverage). Per the simple-skill exception, well-organized sections with no need for external references score 5.

5 / 5

Total

19

/

20

Passed

Description

78%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 concise, uses third person, and explicitly pairs a clear capability statement with an explicit trigger clause of four concrete phrases. Its main weakness is that it names only a single action, and its trigger list misses common synonyms like BDD, behavior-driven, and Cucumber.

Suggestions

Expand the capability statement beyond one action, e.g. "Write BDD scenarios in Gherkin, structure feature files, and turn acceptance criteria into Scenario Outlines."

Add natural trigger synonyms users say for this domain, such as "BDD", "behavior-driven development", "Cucumber", or ".feature files".

DimensionReasoningScore

Specificity

"Write BDD scenarios in Gherkin" names the domain plus one concrete action, matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several actions, so it falls below anchor 4.

3 / 5

Completeness

"Write BDD scenarios in Gherkin" clearly answers what the skill does, and "Trigger: acceptance criteria, Given/When/Then, feature files, test scenarios" explicitly answers when with four concrete trigger phrases. This matches the anchor 5 example where both what and when are explicit with concrete triggers.

5 / 5

Trigger Term Quality

The triggers "acceptance criteria, Given/When/Then, feature files, test scenarios" are natural phrases a user would say in this domain, but common synonyms like "BDD", "behavior-driven", or "Cucumber" are missing, keeping it below anchor 5's comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

"Given/When/Then" and "feature files" are unmistakably Gherkin-specific, giving a clear niche, but broader triggers like "test scenarios" and "acceptance criteria" could also fire for general test-writing skills. That minor overlap with closely related skills matches anchor 4 rather than anchor 5's minimal conflict risk.

4 / 5

Total

16

/

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

YoizenSA/dev-ai-workflow

Path

ywai/skills/gherkin-bdd/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.