acceptance-generator

Converts frozen brief.md files into Gherkin-based acceptance.feature for pytest-bdd.

5|1|Updated May 9, 2026
One-click install
npx skills add https://github.com/ql-link/LinkRag --skill acceptance-generator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: acceptance-generator
Source: https://github.com/ql-link/LinkRag/tree/main/.ai/skills/acceptance-generator
Command: npx skills add https://github.com/ql-link/LinkRag --skill acceptance-generator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates turning a frozen brief.md into executable acceptance tests by converting brief.md into a Gherkin-based acceptance.feature, enabling machine-verified scenarios and faster QA validation.

Core Features & Use Cases

  • Converts a frozen brief.md into an acceptance.feature file for automated testing with pytest-bdd.
  • Generates Given/When/Then scenarios that are directly consumable by automation frameworks.
  • Enforces the frozen brief workflow to prevent generation when brief.md is not frozen.

Quick Start

Convert a frozen brief.md into an acceptance.feature for automated validation with pytest-bdd.

Frequently Asked Questions about acceptance-generator

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

FAQPage Schema
How do I generate Gherkin acceptance tests from a brief.md file?

You can generate Gherkin acceptance tests from a brief.md file by using an automation tool that translates frozen specifications into an acceptance.feature file. The output is directly consumable by pytest-bdd for automated validation.

What does it mean for a brief.md to be frozen before generating acceptance tests?

A frozen brief.md indicates the specification is locked. The generation process enforces this frozen workflow to prevent creating acceptance tests from incomplete requirements, ensuring stable machine-verified scenarios.

Can I use pytest-bdd with the generated acceptance.feature file?

Yes, pytest-bdd works directly with the generated acceptance.feature file. The conversion specifically produces standard Given/When/Then scenarios formatted for consumption by the pytest-bdd automation framework.

How does converting a brief to Gherkin scenarios help QA validation?

Converting a brief to Gherkin scenarios helps QA validation by translating feature-level specifications into machine-checkable tests. This enables automated verification of Given/When/Then steps, accelerating validation cycles.

Why does acceptance test generation fail when the brief.md is not frozen?

Acceptance test generation fails when the brief.md is not frozen because the workflow strictly enforces specification stability. This prevents generating Gherkin scenarios from volatile requirements, avoiding invalid automation outputs.