writing-gherkin

Generate acceptance criteria and Cucumber Gherkin scenarios from feature docs, topics, or change requests.

8|15|Updated Jan 17, 2025
One-click install
npx skills add https://github.com/Netcracker/qubership-envgene --skill writing-gherkin-netcracker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-gherkin
Source: https://github.com/Netcracker/qubership-envgene/tree/main/.claude/skills/writing-gherkin
Command: npx skills add https://github.com/Netcracker/qubership-envgene --skill writing-gherkin-netcracker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing acceptance criteria for a change request and writing Cucumber scenarios for the test suite are usually done separately, so the two drift apart and the suite checks different behavior than the CR promised. This Skill enumerates the observable cases a behavior must satisfy once, then renders that single case list as both collapsed-Gherkin acceptance criteria and full Given/When/Then scenarios. ## Core Features & Use Cases - Case enumeration from three sources: Accepts a filed CR or issue, a subject-area topic, or a single feature/use-case doc, and derives a variation matrix covering happy paths and independent failure modes. - Observable-channel grounding: Verifies every case outcome attaches to an observable channel (log line, error message, emitted request, output file) and that inputs actually trigger the behavior, flagging ungroundable cases instead of rendering vacuous tests. - Dual rendering: Produces collapsed acceptance criteria for CRs and full Cucumber scenarios that reuse the existing suite's step vocabulary, with support for pre-code (design-only) and post-code verification. - Use Case: Given a CR describing a new validation in the qubership-envgene pipeline, generate the acceptance criteria for the issue body plus paste-ready .feature scenarios covering each pipeline flow and failure mode. ## Quick Start Ask the assistant to draft Gherkin scenarios and acceptance criteria for a specific feature doc, topic, or change request in the qubership-envgene repository.

Frequently Asked Questions about writing-gherkin

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write Cucumber Gherkin scenarios for a new feature?

Provide a feature doc, use-case doc, topic, or change request describing the behavior. The skill enumerates the cases the behavior must satisfy, grounds each in an observable channel, then renders full Given/When/Then scenarios reusing the existing suite's step vocabulary.

How do I generate acceptance criteria for a change request or issue?

Point the skill at a filed CR or CR draft that carries a design reference. It reads the scope and linked design, enumerates independent failure modes and happy paths, and renders collapsed-Gherkin acceptance lines, one per independently failing case.

Can Gherkin scenarios be written before the code exists?

Yes. In pre-code mode the skill grounds outcomes against channels named in the design document, such as a specified error message, and marks them as unverified against code. If the design names no observable channel, the case is flagged as an open question.

Why do some generated test cases get flagged as ungroundable?

A case is ungroundable when its outcome has no observable channel, meaning no log line, error, emitted request, or output file a step could assert. Such cases are reported with reasons rather than rendered as tests that would pass vacuously.

When should I not use this Gherkin generation skill?

Do not use it to review or grade scenarios that already exist, to file the CR issue itself, or to write step definitions and test code. Those belong to separate skills; this one only authors new cases and their two renderings.