CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

testland/gherkin-from-stories

Use whenever user stories, acceptance criteria, manual test steps or a spec section need to become Gherkin .feature files. Maps criteria to scenarios, finds Scenario Outlines and Background, reuses existing steps and flags hidden preconditions. Writes Gherkin only, not step code.

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

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.

A well-engineered instruction-only skill: four input shapes each get concrete worked examples and validation rules, deep material is correctly factored into three one-level-deep reference files, and the flag-and-ask pattern provides a real feedback loop. The only cost is minor verbosity (a quoted ISTQB definition and light redundancy between the routing table and When-to-use section).

DimensionReasoningScore

Conciseness

The body is example-driven and assumes Gherkin competence — no 'what is Gherkin' padding — with compact tables for routing and anti-patterns. Minor trimmable instances remain: the quoted ISTQB ATDD definition ("a collaboration-based test-first approach that defines acceptance tests…") and slight overlap between the routing table and the 'When to use' section, fitting the level-4 anchor 'minor instances of over-explanation' rather than level 5's every-token-earns-its-place.

4 / 5

Actionability

Each input shape gets copy-paste-ready worked Gherkin (promo-code feature, Scenario Outline with Examples table), a compressed but concrete rule catalog ("remove UI mechanics, collapse multi-step UI sequences into one business action, replace UI properties with observable outcomes…"), and an exact output template with the side-by-side rewrite table and new-steps table. Specific examples cover the common cases, matching the level-5 anchor; this is not level 4 because there are no meaningful gaps in executable guidance.

5 / 5

Workflow Clarity

Sequenced steps per input shape (Step 1-3 for stories; numbered 1-5 for ATDD, manual steps, and spec extraction) with explicit validation checkpoints ("Validate: at most one When per scenario; lint; specificity preserved"; "Validate observability of every Then") and a flag-and-ask feedback loop that halts authoring until the PM answers implicit Givens. This matches the level-5 anchor's explicit validation, feedback loops, and output-template checklist.

5 / 5

Progressive Disclosure

SKILL.md is a genuine overview: each deep topic is split into a real, one-level-deep bundle file ([references/atdd-traceability.md], [references/manual-step-rules.md], [references/spec-extraction-examples.md] — all present, none nesting further references), each signaled in-section with what it contains and repeated in a References section with annotations. This matches the level-5 anchor for well-signaled one-level-deep references with easy navigation.

5 / 5

Total

19

/

20

Passed

Description

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

A strong description: explicit 'Use whenever' trigger clause, four concrete capability statements, and a clear output boundary. The only gap is a few natural synonyms (BDD, Cucumber, Given/When/Then) that users might say when they need this skill.

DimensionReasoningScore

Specificity

Quotes multiple concrete actions covering the whole transform: "Maps criteria to scenarios", "finds Scenario Outlines and Background", "reuses existing steps", "flags hidden preconditions", plus an explicit output boundary "Writes Gherkin only, not step code". Coverage is comprehensive for the domain, matching the anchor for multiple specific concrete actions rather than the level-4 anchor's 'minor gaps'.

5 / 5

Completeness

Explicitly answers both questions: "Use whenever user stories, acceptance criteria, manual test steps or a spec section need to become Gherkin .feature files" is a concrete when-clause, and the action list answers what. This matches the level-5 anchor (both what and when with concrete trigger phrases); level 4 would require the 'when' to be less explicit.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — "user stories", "acceptance criteria", "manual test steps", "spec section", "Gherkin", ".feature files" — giving good keyword coverage. A few common natural terms are missing (e.g. "BDD", "Cucumber", "Given/When/Then", "test scenarios"), which fits the level-4 anchor rather than level 5's comprehensive synonym coverage, but is well above level 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

Clear niche (requirements text → Gherkin .feature files) with distinct triggers and an explicit exclusion ("Writes Gherkin only, not step code") that separates it from step-definition/runner skills, giving minimal conflict risk. Not level 4, because that anchor reserves overlap risk with closely related skills, and the description's boundary clause handles its nearest neighbors.

5 / 5

Total

19

/

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.

Reviewed

On this page