Agent skill

Technical Design Doc Creator

by tech-leads-club in tech-leads-club/agent-skills

Creates comprehensive Technical Design Documents (TDD) with mandatory and optional sections through interactive discovery.

Custom licenceAuto-check passedDevelopment

Install Technical Design Doc Creator

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tech-leads-club/agent-skills technical-design-doc-creator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tech-leads-club/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'packages/skills-catalog/skills/(creation)/create-technical-design-doc' .claude/skills/technical-design-doc-creator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
technical-design-doc-creator
GitHub stars
7k
Token cost
~13k tokens
SKILL.md length
1,996 words
Files
2
Skills in repo
74
Repo updated
First seen
Licence
Custom licence

At a glance

Creates comprehensive Technical Design Documents (TDD) with mandatory and optional sections through interactive discovery.

  • Works in 12 steps: Initial Gathering → Validate Mandatory Information → Check for Critical Sections → …
  • User asks to write a design doc
  • SKILL.md covers When to Use This Skill, Language Adaptation, Industry Standards Reference and High-Level vs Implementation…, plus 4 more sections
  • Calls nx and kubectl; reaches api.launchdarkly.com; needs API_KEY and STRIPE_SECRET_KEY

What it does

Technical Design Doc Creator is an agent skill from tech-leads-club/agent-skills. Creates comprehensive Technical Design Documents (TDD) with mandatory and optional sections through interactive discovery. Use when user asks to "write a design doc", "create a TDD", "technical spec", "architecture document", "RFC", "design proposal", or needs to document a technical decision before implementation. Do NOT use for README files, API docs, or general documentation (use docs-writer instead).

Its SKILL.md is about 13k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Development, covering Architecture decision records, Technical documentation and Test-driven development. The repository describes itself as: The secure, validated skill registry for professional AI coding agents. Extend Antigravity, Claude Code, Cursor, Copilot and more with absolute confidence.

When your agent uses it

  • User asks to write a design doc
  • Architecture document
  • Design proposal
  • Needs to document a technical decision before implementation

Example prompts

  • “write a design doc”
  • “create a TDD”
  • “technical spec”
  • “/technical-design-doc-creator”

Requirements

  • A credential in API_KEY

Workflow steps

12 steps, taken from the step headings in SKILL.md.

  1. Initial Gathering
  2. Validate Mandatory Information
  3. Check for Critical Sections
  4. Offer Suggested Sections
  5. Generate Document
  6. Offer Confluence Integration
  7. Header & Metadata (MANDATORY)
  8. Context (MANDATORY)
  9. Problem Statement & Motivation (MANDATORY)
  10. Scope (MANDATORY)
  11. Technical Solution (MANDATORY)
  12. Implementation Plan (MANDATORY)

What it can do on your machine

Read from SKILL.md and the folder at commit 6df68d5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • nx
    • kubectl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.launchdarkly.com

    Also links to:

    • google.github.io
    • sre.google
    • owasp.org
    • adr.github.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • API_KEY
    • STRIPE_SECRET_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Technical Design Doc Creator loads about 13k tokens when it runs. Until then it costs about 109 tokens; SKILL.md has 1,996 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~109
When it runs · the whole SKILL.md, loaded when a task matches
~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,996 words (~12,915 tokens).

“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.”

— opening of SKILL.md by tech-leads-club, Custom licence
name
technical-design-doc-creator

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in packages/skills-catalog/skills/(creation)/create-technical-design-doc of tech-leads-club/agent-skills.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 6df68d5

Compare with similar skills

Technical Design Doc Creator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Technical Design Doc Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Technical Design Doc Creator this skilltech-leads-club/agent-skills7k—~13kAutomated safety check: PassCustom licence
Development Workflowrunceel/ReactiveProperty944—~1.4kAutomated safety check: PassMIT
Docsbrickbots/PiFinder250—~6.2kAutomated safety check: PassGPL-3.0
Evidence-Backed Documentation Writerbgauryy/octocode949—~2kAutomated safety check: PassMIT
Write Vibe ADRmistralai/mistral-vibe5.1k—~942Automated safety check: PassApache-2.0
Technical Documentation Templatesbybren-llc/safe-agentic-workflow423—~1.2kAutomated safety check: PassMIT

Similar skills

  • Development Workflow

    runceel/ReactiveProperty

    ReactiveProperty repository development policy. An agent skill from runceel/ReactiveProperty.

    944 GitHub stars~1.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Docs

    brickbots/PiFinder

    Author and edit PiFinder's user-facing documentation in the project's house style.

    250 GitHub stars~6.2k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Writes, repairs and copyedits project docs against the Google developer documentation style guide, verifying claims in the repository before stating them.

    949 GitHub stars~2k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Write Vibe ADR

    mistralai/mistral-vibe

    Official

    Creates or updates concise Architecture Decision Records for the Mistral Vibe CLI and registers each one in the AGENTS.md decisions table.

    5.1k GitHub stars~942 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Technical Documentation Templates

    bybren-llc/safe-agentic-workflow

    Documentation templates for ADRs, runbooks, architecture docs, and knowledge transfer documents. Use when creating Architecture Decision Records, writing…

    423 GitHub stars~1.2k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Agent Style

    pchalasani/claude-code-tools

    Literature-backed English technical-prose writing rules (agent-style, 21 rules).

    2k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed

More from tech-leads-club/agent-skills

All 74 skills in this repo
  • Evolutionary Modular Architecture

    tech-leads-club/agent-skills

    Guides design of modular-monolith platforms with DDD, flat-by-aggregate modules, anti-corruption layers, outbox events and resilience, plus an architecture document with SVG diagrams.

    7k GitHub stars~3.7k tokensUpdated yesterday
    Auto-check passed
  • Excalidraw Diagram Studio

    tech-leads-club/agent-skills

    Generates Excalidraw diagram files from plain descriptions, choosing among flowcharts, mind maps, architecture, swimlane, class, sequence and ER diagrams.

    7k GitHub stars~3.6k tokensUpdated yesterday
    Auto-check passed
  • Mermaid Studio

    tech-leads-club/agent-skills

    Creates, validates and renders Mermaid diagrams to SVG, PNG or ASCII, including C4 and AWS architecture-beta, flowcharts, sequence diagrams and ERDs.

    7k GitHub stars~4.6k tokensUpdated yesterday
    Auto-check passed
  • AWS Cloud Advisor

    tech-leads-club/agent-skills

    Answers AWS architecture, security and service-selection questions by searching AWS documentation through MCP tools first, then adapting advice to your stack and team.

    7k GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Harness Eval

    tech-leads-club/agent-skills

    Evaluates a repository's agent harness (AGENTS.md, rules, skills) for broken paths, redundant instructions and usefulness, and stops at reports.

    7k GitHub stars~3.9k tokensUpdated yesterday
    Auto-check passed
  • NestJS Modular Monolith Architect

    tech-leads-club/agent-skills

    Designs scalable NestJS modular monoliths with domain-driven design, Clean Architecture layers and optional CQRS, defining bounded contexts and strict module boundaries.

    7k GitHub stars~3.9k tokensUpdated yesterday
    Auto-check passed

Questions about Technical Design Doc Creator

What does Technical Design Doc Creator do?

Creates comprehensive Technical Design Documents (TDD) with mandatory and optional sections through interactive discovery. Technical Design Doc Creator is an agent skill from tech-leads-club/agent-skills. Creates comprehensive Technical Design Documents (TDD) with mandatory and optional sections through interactive discovery.

When should I use Technical Design Doc Creator?

Technical Design Doc Creator fits situations like: user asks to write a design doc; architecture document; design proposal; needs to document a technical decision before implementation.

How do I install Technical Design Doc Creator in Claude Code?

Run `npx skills add tech-leads-club/agent-skills --skill technical-design-doc-creator -a claude-code`. Or copy the skill folder (packages/skills-catalog/skills/(creation)/create-technical-design-doc in tech-leads-club/agent-skills) into .claude/skills/technical-design-doc-creator in your project. Claude Code loads it when a task matches its description.

How do I install Technical Design Doc Creator in Codex?

Run `npx skills add tech-leads-club/agent-skills --skill technical-design-doc-creator -a codex`. Or copy the skill folder (packages/skills-catalog/skills/(creation)/create-technical-design-doc in tech-leads-club/agent-skills) into .agents/skills/technical-design-doc-creator in your project. Codex loads it when a task matches its description.

Can I use Technical Design Doc Creator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tech-leads-club/agent-skills --skill technical-design-doc-creator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/technical-design-doc-creator, .gemini/skills/technical-design-doc-creator, .github/skills/technical-design-doc-creator and .opencode/skills/technical-design-doc-creator in your project.

What does Technical Design Doc Creator need to run?

Going by SKILL.md and its folder, Technical Design Doc Creator needs the command-line tools its instructions call (nx and kubectl) and credentials named API_KEY and STRIPE_SECRET_KEY. Our summary lists: A credential in API_KEY.

Does Technical Design Doc Creator access the network?

SKILL.md names 5 domains. In commands or code: api.launchdarkly.com; the agent is likely to contact it when it follows the instructions. As links in the text: google.github.io, sre.google, owasp.org and adr.github.io. This is read from the text; nothing was executed.

Is Technical Design Doc Creator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Technical Design Doc Creator use?

Technical Design Doc Creator has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Technical Design Doc Creator use?

About 13k tokens (SKILL.md is roughly 52k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Technical Design Doc Creator?

Skills that share tags, products or a category with Technical Design Doc Creator: Development Workflow (runceel/ReactiveProperty, 944 stars), Docs (brickbots/PiFinder, 250 stars), Evidence-Backed Documentation Writer (bgauryy/octocode, 949 stars) and Write Vibe ADR (mistralai/mistral-vibe, 5.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Technical Design Doc Creator?

tech-leads-club (a GitHub organization) maintains it in tech-leads-club/agent-skills, which has 7,045 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on October 9, 2026.

Source: tech-leads-club/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.