# spec-writing

> Claude/Codex skill by [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars · Updated 2026-10-16

This skill should be used when writing specs, acceptance criteria, or slicing features into vertical slices. Contains adaptive depth by risk and out-of-scope capture.

## Install

```sh
git clone https://github.com/incubyte/ai-plugins /tmp/ai-plugins && ln -s /tmp/ai-plugins/bee/skills/spec-writing ~/.claude/skills/spec-writing
```

## From README

Spec Writing What Makes Good Acceptance Criteria Each criterion is a single, testable statement. It describes one observable behavior in one sentence. Good: Bad: The test: Can a developer write a test from this criterion without asking clarifying questions? If yes, it's good. If no, it needs more detail. Rules for Good ACs One behavior per AC. If you wrote "and" in the middle, split it into two. Observable outcome. Someone can look at the screen or the API response and verify it. No implementation details. Say "Shows error when email is taken", not "Returns 409 Conflict with JSON error body." Include error cases explicitly. "Shows error when..." ACs are first-class, not afterthoughts. No vague qualifiers. Never use "correctly", "properly", "well", "appropriate" without defining what that means. Code in Specs Small indicative code is fine when it clarifies intent: Use code to show contracts and shapes. Never use code to show logic — that's the TDD planner's job.

## Links

- HTML page: https://omgskills.com/library/incubyte/ai-plugins/bee/skills/spec-writing/
- GitHub: https://github.com/incubyte/ai-plugins
- Author: [@incubyte](https://omgskills.com/library/incubyte/index.md)

## More from this repo

- [ai-ergonomics](https://omgskills.com/library/incubyte/ai-plugins/bee/skills/ai-ergonomics/index.md) — This skill should be used when evaluating how well code supports LLM-assisted development.
   - [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars
- [ai-workflow](https://omgskills.com/library/incubyte/ai-plugins/bee/skills/ai-workflow/index.md) — This skill should be used when explaining why Bee follows spec-first TDD workflows, or when teaching mode is on.
   - [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars
- [architecture-patterns](https://omgskills.com/library/incubyte/ai-plugins/bee/skills/architecture-patterns/index.md) — This skill should be used when evaluating architecture options, checking dependency direction, or deciding between...
   - [@incubyte](https://omgskills.com/library/incubyte/index.md) · 18 stars