# Design Doc

> For when you're asked to write a design doc or specification, especially after a brainstorm or feature design session.

- Skill: `tools-only/design-doc` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds add tools-only/design-doc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tools-only/design-doc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: tools-only (https://skillmd.com/u/tools-only)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/tools-only/design-doc

---


# Design Doc

This skill is for when you're asked to write a design document or design specification, especially after a brainstorm or feature design session.

Design docs go into the `docs/` directory in the project root. Create the folder if it doesn't exist.
The design doc is in Markdown. Choose a concise, relevant name yourself.

## Content

- Be concise.
- Don't include too many code examples, unless necessary because they contain valuable details uncovered during the brainstorm or design session.