Design Doc
Turns technical feature requests into proper design docs with all the sections engineers actually need: context, constraints, implementation outline, acceptance criteria, and testing approach. Uses Setext-style markdown headers and pushes you to be specific about behavior, like "max 100 chars" instead of vague handwaving. The workflow is straightforward: gather context, fill out the template, make sure your acceptance criteria are testable. Worth having if you're tired of design docs that skip error handling or forget to define what "done" means. The emphasis on non-goals is smart, helps keep scope creep in check before you start building.
- skills.sh installs
- 372
- GitHub stars
- 33
- last updated
- Aug 21, 2026
Install
$ npx -y skills add diskd-ai/design-doc --skill design-doc --agent claude-codeInstalls into .claude/skills of the current project.
Files
Technical Design Document Skill
Create structured technical design documents that communicate system behavior, implementation approach, and acceptance criteria.
Workflow
- Gather context: Understand the feature/system scope, constraints, and goals
- Draft structure: Use template from
references/template.md - Fill sections: Work through each section, asking clarifying questions as needed
- Review: Ensure acceptance criteria are testable and implementation outline is actionable
Template
See references/template.md for the full template structure and section guidelines.
Core sections:
- Context and motivation: Problem statement, goals, non-goals
- Implementation considerations: Constraints and design principles
- High-level behavior: End-to-end system behavior
- Domain-specific sections: Adapt to feature type (discovery, validation, API, state, rendering)
- Error handling and UX: Error surfacing and recovery
- Future-proofing: Design for extensibility
- Implementation outline: Step-by-step approach
- Testing approach: Unit, integration, manual tests
- Acceptance criteria: Testable conditions for "done"
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/diskd-ai/design-doc
- Categories
- Backend & APIs, Documentation, Code Review & Quality, Productivity & Planning, Design & UI/UX, Databases
- First seen
- Jun 3, 2026
Recommended
More Backend & APIs
langgraphyonatangross/orchestkitLangGraph 1.x (LTS) Python workflow patterns for state management, delta channels, resilience (node timeouts, error handlers, graceful drain), routing, parallel371skills.sh installs
azure-devopssanjay3290/ai-skillsManage Azure DevOps projects, work items, repos, PRs, pipelines, wikis, test plans, security alerts, variable groups, environments/approvals, branch policies, a369skills.sh installs
cloudflare-workers-securitysecondsky/claude-skillsCloudflare Workers security with authentication, CORS, rate limiting, input validation. Use for securing APIs, JWT/API keys, or encountering auth failures, CORS369skills.sh installs
googlevercel-labs/emulateEmulated Google OAuth 2.0, OpenID Connect, Gmail, Calendar, and Drive for local development and testing. Use when the user needs to test Google sign-in locally,369skills.sh installs
pma-bunzzci/skillsBun implementation guide for PMA-managed backend services and internal tools. Covers project layout and monorepo promotion, required quality gates, SQLite-first364skills.sh installs