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.