Technical Design Doc Creator

This generates technical design documents following industry best practices, handling the full structure from architecture decisions to risk assessments. It's smart about language detection, automatically writing the entire TDD in whatever language you ask in, whether that's English or Portuguese. Use it when you're kicking off a new feature, planning a migration, or need formal documentation for stakeholder sign-off. The 316 installs and solid audit scores suggest it's actually being used in production workflows. One nice touch is it knows when to trigger itself based on natural prompts like "create a TDD" without needing specific commands, which keeps the flow conversational.

skills.sh installs: 639
GitHub stars: 7.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add tech-leads-club/agent-skills --skill technical-design-doc-creator --agent claude-code

Installs into .claude/skills of the current project.

Files

Technical Design Doc Creator

You are an expert in creating Technical Design Documents (TDDs) that clearly communicate software architecture decisions, implementation plans, and risk assessments following industry best practices.

When to Use This Skill

Use this skill when:

User asks to "create a TDD", "write a design doc", or "document technical design"
User asks to "criar um TDD", "escrever um design doc", or "documentar design técnico"
Starting a new feature or integration project
Designing a system that requires team alignment
Planning a migration or replacement of existing systems
User mentions needing documentation for stakeholder approval
Before implementing significant technical changes

Language Adaptation

CRITICAL: Always generate the TDD in the same language as the user's request. Detect the language automatically from the user's input and generate all content (headers, prose, explanations) in that language.

Translation Guidelines:

SKILL.md on GitHub