bdd-anti-patterns SKILL.md skillA

bdd-anti-patterns from aks-builds/quality-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add aks-builds/quality-skills/bdd-anti-patterns@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
aks-builds/quality-skills
Path
skills/bdd-anti-patterns/SKILL.md
Versions recorded
1
Latest version
v1.0.0, committed May 16, 2026
Size
11,479 bytes
Repository stars
5
License
MIT

When the user wants to audit, refactor, or rescue a Cucumber / Gherkin / SpecFlow / Reqnroll / behave BDD suite from common failure modes. Use when the user mentions "BDD anti-patterns," "Gherkin anti-patterns," "scenario refactoring," "imperative steps," "feature file review," "BDD smells," "BDD failing," "Cucumber feedback loop," "scenarios as scripts," or "is BDD worth it." For Cucumber/Gherkin basics see cucumber-gherkin. For .NET BDD see specflow-reqnroll. For Python BDD see behave.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# BDD Anti-Patterns

You are an expert in identifying and fixing the failure modes that sink BDD adoptions. Your goal is to help engineers and teams diagnose what's gone wrong in a Gherkin / Cucumber / SpecFlow / Reqnroll / behave suite, refactor toward genuine behavior-driven specifications, and — when appropriate — recognize that BDD wasn't the right tool and recommend a graceful exit. Be honest. Don't fabricate Gherkin syntax or BDD principles. When uncertain about citation, reference Dan North's BDD writings, Cucumber.io docs, and the broader BDD community.

## Initial Assessment

Check `.agents/qa-context.md` (fallback: `.claude/qa-context.md`) before answering. Pay attention to:

- **Who actually writes features?** — Engineers only? Product / BA / engineers together? This determines whether BDD is paying for itself.
- **Who reads features?** — If the answer is "the build pipeline and grep," scenarios are not specifications anymore; they're slow unit tests in costume.
- **Maintenance metric** — How many features have been deleted in the last quarter? A healthy suite shrinks as well as grows.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add aks-builds/quality-skills/bdd-anti-patterns@sha256:76c617ee904cc370

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_f2i5z6p3ifsw24c4.svg)](https://markdownregistry.com/a/art_f2i5z6p3ifsw24c4)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 16, 2026.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-05-16 3b818cb 11,479 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11479 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

aks-builds/quality-skills · 5 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_f2i5z6p3ifsw24c4
GET https://markdownregistry.com/api/v1/resolve?ref=aks-builds/quality-skills/bdd-anti-patterns
GET https://markdownregistry.com/api/v1/blob/76c617ee904cc370ce97d76774ffa6dd9248aed5992f186abcc4f413a2d6d8cd

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from aks-builds/quality-skills

AGENTS.md AGENTS.md file
aks-builds/quality-skills · AGENTS.md
git:20260516.3b818cb · audit A · 5 stars
CLAUDE.md CLAUDE.md file
aks-builds/quality-skills · CLAUDE.md
git:20260516.3b818cb · audit A · 5 stars
qa-engineering-suite SKILL.md skill
aks-builds/quality-skills · SKILL.md · 107 production-grade QA engineering skills covering frontend, API, performance, mobile, security, CI, and AI/LLM…
git:20260620.bbe2ab9 · audit A · 5 stars
accessibility-testing SKILL.md skill
aks-builds/quality-skills · skills/accessibility-testing/SKILL.md · When the user wants to design, implement, or operate accessibility (a11y) testing — automated scans, manual audits…
v1.0.0 · audit A · 5 stars
ai-augmented-testing SKILL.md skill
aks-builds/quality-skills · skills/ai-augmented-testing/SKILL.md · When the user wants to evaluate, adopt, or operate AI-augmented testing tools and approaches — autonomous test…
v1.0.0 · audit A · 5 stars
appium SKILL.md skill
aks-builds/quality-skills · skills/appium/SKILL.md · When the user wants to design, implement, debug, or scale Appium tests for iOS and Android mobile automation. Use when…
v1.0.0 · audit A · 5 stars
artillery SKILL.md skill
aks-builds/quality-skills · skills/artillery/SKILL.md · When the user wants to design, implement, debug, or operate Artillery load tests. Use when the user mentions…
v1.0.0 · audit A · 5 stars
behave SKILL.md skill
aks-builds/quality-skills · skills/behave/SKILL.md · When the user wants to design, implement, debug, or operate BDD tests on Python using behave. Use when the user…
v1.0.0 · audit A · 5 stars
chaos-engineering SKILL.md skill
aks-builds/quality-skills · skills/chaos-engineering/SKILL.md · When the user wants to design, run, or operate chaos experiments to validate system resilience. Use when the user…
v1.0.0 · audit A · 5 stars
ci-test-orchestration SKILL.md skill
aks-builds/quality-skills · skills/ci-test-orchestration/SKILL.md · When the user wants to design, audit, or optimize how tests run in CI — sharding, matrix builds, parallelism, retry…
v1.0.0 · audit A · 5 stars
cloud-test-grids SKILL.md skill
aks-builds/quality-skills · skills/cloud-test-grids/SKILL.md · When the user wants to design, integrate, or operate against a cloud-hosted browser / device test grid — BrowserStack…
v1.0.0 · audit A · 5 stars
code-coverage SKILL.md skill
aks-builds/quality-skills · skills/code-coverage/SKILL.md · When the user wants to measure, interpret, or improve code coverage — line, branch, function, statement, condition…
v1.0.0 · audit A · 5 stars

Every file in aks-builds/quality-skills

Browse by kind, by grade A, or by owner.