design-craft

Generates multi-document technical design documents from requirement descriptions with staged user confirmation.

2|Updated Jun 8, 2026
One-click install
npx skills add https://github.com/HACK-WU/skills --skill design-craft-hack-wu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-craft
Source: https://github.com/HACK-WU/skills/tree/main/skills/design-craft
Command: npx skills add https://github.com/HACK-WU/skills --skill design-craft-hack-wu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a raw requirement description into a review-ready technical design document is error-prone: ambiguous terms get misinterpreted, complexity gets hidden in a single document, and designs drift from the existing codebase. This Skill structures the entire process so designs are split into a parent document plus sub-requirement documents, validated against the real code, and reviewed automatically before delivery. ## Core Features & Use Cases - Staged design workflow: Walks through requirement maturity assessment, semantic analysis, interaction mapping, requirement splitting into a dependency DAG, outline definition, chapter-by-chapter filling, and archival, with user confirmation required at each stage. - Multi-document structure by default: Splits complex requirements into a parent document (4 global chapters) plus per-sub-requirement documents with on-demand chapters, while simple changes can use a 14-chapter single-document fast track. - Automated review loop: After writing files, it runs design-review with up to 3 auto-fix rounds, then challenger second-round questioning and scenario rehearsal, with options to auto-fix, archive reports, or skip. - Use Case: Given a requirement like "simplify the import flow from 7 steps to 2", the Skill splits it into sub-requirements with a mermaid overview diagram, produces interface contracts with demo JSON responses and decision tables with rejected alternatives, then archives everything under the requirement directory and registers it via the req CLI. ## Quick Start Ask the AI to turn your requirement description into a technical design document, for example: use design-craft to create a design doc for adding idempotency to the task system.

Frequently Asked Questions about design-craft

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

FAQPage Schema
How do I generate a technical design document from a requirement description?

Provide a reasonably complete requirement description and the Skill walks you through staged phases: requirement summary confirmation, semantic analysis, interaction overview, requirement splitting, outline, and chapter filling. Each stage waits for your confirmation before continuing.

When should a design be split into multiple documents versus a single document?

Splitting is the default. A single-document fast track applies only when there is no flow change, at most 3 files or 100 lines changed, no cross-module interaction, and the user explicitly confirms no split is needed.

Does the design workflow integrate with requirement management tools?

Yes. When a .requirements/config with a valid storage_path exists, documents are written to the requirement directory and registered via the req update CLI command with status and changelog updates.

What happens after the design document is written?

It enters an automatic review loop with design-review (up to 3 auto-fix rounds), then challenger second-round questioning and scenario rehearsal. After each report you choose to auto-fix, archive the report, or skip.

When should I not use this design document generator?

Do not use it for one-line ideas or vague thoughts that still need requirement clarification. It requires a fairly complete requirement description and does not replace requirement analysis or product design.