# Af Write Scenario Specs

> Write BDD Markdown scenario specifications with Preconditions, Steps, and Expected outcomes. Use when creating scenario files from requirements, mini-PRDs, or translating acceptance criteria into testable specs.

- Skill: `majiayu000/af-write-scenario-specs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/af-write-scenario-specs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/af-write-scenario-specs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/af-write-scenario-specs

---


# Writing Scenarios

## What to read

**Scenario format (Preconditions/Steps/Expected structure):**
→ [bdd-guide.md#scenario-format](../../docs/guides/bdd-guide.md#scenario-format)

**Test type classification (E2E, Integration, Component, Unit):**
→ [bdd-guide.md#test-type-classification](../../docs/guides/bdd-guide.md#test-type-classification)

**Coverage requirements (happy path, errors, boundaries, validation):**
→ [bdd-guide.md#coverage-requirements](../../docs/guides/bdd-guide.md#coverage-requirements)

**Selector contracts for test IDs:**
→ [bdd-guide.md#selector-contracts](../../docs/guides/bdd-guide.md#selector-contracts)

**For comprehensive BDD rules, language rules, and pitfalls:**
→ [af-write-bdd-scenarios/SKILL.md](../af-write-bdd-scenarios/SKILL.md)