design-doc

Generate formal design documents from product briefs and PRDs.

Updated Jan 31, 2026
One-click install
npx skills add https://github.com/token-overflow/tokenoverflow --skill design-doc-token-overflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-doc
Source: https://github.com/token-overflow/tokenoverflow/tree/main/.agents/skills/design-doc
Command: npx skills add https://github.com/token-overflow/tokenoverflow --skill design-doc-token-overflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Solves the problem of missing upfront design by automating formal design-document creation.

Core Features & Use Cases

  • Guides design leads to create a complete design document from the product brief and PRD.
  • Ensures multiple design alternatives with trade-offs, alignment checks, and approval steps.
  • Stores the resulting design in docs/design/ and references PRD/design templates.

Quick Start

Read the product brief and PRD, then initiate the design workflow to create a design document for the new feature.

Frequently Asked Questions about design-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate design document creation from a PRD?

Automate design document creation by initiating a workflow that requires a product brief and PRD review. The process guides you through generating design documents with required sections, multiple design alternatives, and trade-offs before storing them in docs/design/.

What is the best way to enforce design discipline before coding?

Enforce design discipline by integrating an automated workflow that mandates PRD review and formal design-document generation. This ensures alignment checks and approval steps are completed before development begins, preventing missing upfront design.

Do I need a product brief to start the design documentation workflow?

Yes, you need a product brief and a PRD to start the design documentation workflow. The process targets feature planning by requiring these inputs to guide the generation of design documents and validate necessary trade-offs.

How do I validate design documents for compliance with documentation standards?

Validate design documents by checking YAML frontmatter, section structure, and approval steps. The workflow ensures compliance with documentation standards by verifying these elements during the formal design-document creation process.

Can I compare multiple design alternatives with trade-offs in my design doc?

Yes, the design document workflow ensures multiple design alternatives with trade-offs are included. It guides design leads to generate these alternatives alongside alignment checks and approval steps within the formal document.

Where are generated design documents stored in the repository?

Generated design documents are stored in the docs/design/ directory. The workflow references PRD and design templates to ensure the resulting design files comply with documentation standards and required section structures.