---
slug: "bdd-best-practices"
source_type: "skill_md"
source_url: "https://cdn.jsdelivr.net/gh/viktor-silakov/bdd-best-practices@main/SKILL.md"
repo: "https://github.com/viktor-silakov/bdd-best-practices"
source_file: "SKILL.md"
branch: "main"
---
---
name: auditing-bdd-tests
description: Analyzes BDD (Gherkin) + Playwright test solutions. Produces aspect scoring (0/5/10), A–F grade, issues by severity, and Markdown + HTML report formats for deep test-solution analysis.
user-invocable: true
argument-hint: [path-to-repo]
---

# BDD Test Solution Audit (Gherkin + Playwright)

The main skill file is located at `skills/auditing-bdd-tests/SKILL.md` (structured like `ai-ready`).

Use it directly or as a reference when installing the skill to `.claude/skills/`.

- Skill: `skills/auditing-bdd-tests/SKILL.md`
- Rubric: `skills/auditing-bdd-tests/criteria/aspects.md`
- Severity: `skills/auditing-bdd-tests/reference/severity.md`
- Best practices guide: `skills/auditing-bdd-tests/reference/bdd-best-practices.md`