🧪 Spec
Build requirements specification through structured discovery interview. Use when defining scope, gathering requirements, or specifying WHAT work should accomplish - features, bugs, refactors, infrastructure, migrations, performance, documentation, or any other work type. Triggers: spec, requirement
npx playbooks add skill doodledood/codex-workflow --skill spec
About Spec
Built for testing & qa workflows, Spec helps AI coding agents build requirements specification through structured discovery interview. use when defining scope, gathering requirements, or specifying what work should accomplish - features, bugs, refactors, infrastructure, migrations, performance, documentation, or any other work type. triggers: spec, requirement.
The 35-word prompt provides structured testing & qa guidance — covering detailed methodology and consistent output formats. Install it in one command.
Use Cases
- Writing unit, integration, and end-to-end tests
- Setting up test coverage and CI pipelines
- Refactoring legacy code with confidence using tests
- Creating test plans and QA checklists
Example Prompts
System Prompt (35 words)
Build requirements specification through structured discovery interview. Use when defining scope, gathering requirements, or specifying WHAT work should accomplish - features, bugs, refactors, infrastructure, migrations, performance, documentation, or any other work type. Triggers: spec, requirement
Frequently Asked Questions
What is Spec?
Spec is a free testing & qa skill for AI coding agents. Build requirements specification through structured discovery interview. Use when defining scope, gathering requirements, or specifying WHAT work should accomplish - features, bugs, refactors, infrastructure, migrations, performance, documentation, or any other work type. Triggers: spec, requirement. It provides a specialized system prompt that configures your agent with testing & qa expertise.
How do I use Spec with Claude Code?
Run npx playbooks add skill doodledood/codex-workflow --skill spec in your terminal to install Spec into your Claude Code session. It works immediately after installation.
Which AI coding agents work with Spec?
Spec is compatible with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenClaw, Cline, and any AI agent that supports custom system prompts or .cursorrules files.
Is Spec free to use?
Yes, Spec is completely free and open source. The full source is available on GitHub at https://github.com/doodledood/codex-workflow/tree/main/skills/spec. You only need a subscription to the AI agent you use it with.
