technical-design-doc-creator

Generates comprehensive Technical Design Documents with architecture, API contracts, and risks.

1|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/marcius-llmus/skills --skill technical-design-doc-creator-marcius-llmus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: technical-design-doc-creator
Source: https://github.com/marcius-llmus/skills/tree/main/%28creation%29/create-technical-design-doc
Command: npx skills add https://github.com/marcius-llmus/skills --skill technical-design-doc-creator-marcius-llmus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams produce Technical Design Documents (TDDs) that codify architecture decisions, API contracts, data flows, and risk assessments, enabling clear communication and faster alignment with stakeholders.

Core Features & Use Cases

  • Generates a comprehensive TDD including header/metadata, context, problem statement, scope, technical solution, risks, and implementation plan.
  • Enforces mandatory sections while offering optional sections (security considerations, testing strategy, monitoring, rollback) depending on project type and size.
  • Interactive information gathering: prompts for missing inputs and validates critical sections before finalization.
  • Suitable for new features, external integrations, migrations, and infrastructure changes across various languages and domains.

Quick Start

Provide a project name and high-level goals to begin generating your TDD.

Frequently Asked Questions about technical-design-doc-creator

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

FAQPage Schema
How do I draft a technical design document for a new software architecture?

To draft a technical design document, provide a project name and high-level goals. The system interactively gathers missing inputs to generate a comprehensive TDD capturing architecture decisions, API contracts, and risk assessments.

What sections are mandatory when creating a TDD for stakeholder alignment?

A TDD requires header metadata, context, problem statement, scope, technical solution, risks, and an implementation plan. Optional sections include security considerations, testing strategy, monitoring, and rollback procedures.

Can I generate technical design documents for external integrations and migrations?

Yes, you can generate technical design documents for external integrations, migrations, and infrastructure changes. The system adapts its required sections based on the specific project type and size.

What is the best way to document API contracts and data flows for a new feature?

The best way to document API contracts and data flows is using a standardized TDD format. This codifies architecture decisions and risk assessments, enabling clear communication and faster alignment with stakeholders.

Does the TDD generation process work if I only have high-level project goals?

Yes, if you only have high-level goals, the TDD generation process works by interactively prompting you for missing inputs. It validates critical information before finalizing the technical design document.

When should I include optional sections like rollback and monitoring in a technical design document?

You should include optional sections like rollback and monitoring in a technical design document depending on your project type and size. The system enforces mandatory sections while offering these additions for complex infrastructure changes.