technical-design-doc-creator

technical-design-doc-creator is a skill for Claude Code, Codex from barateza/mcp-plesk-dev-docs. It costs 32 tokens per session (11,912 once invoked), scanned A, original, MIT.

A workflow for creating a Technical Design Document, or TDD—a written plan that explains a system’s architecture, implementation, decisions, and risks. It gathers missing information and follows a defined set of required and optional sections.

In plain words
What is it for?
Use it for new features or integrations, migrations, system replacements, major technical changes, and work that needs team or stakeholder approval.
Why use it?
It gives developers and stakeholders a shared explanation of a significant change before implementation begins. This makes design choices, open questions, and risks easier to review.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/barateza/mcp-plesk-dev-docs/technical-design-doc-creator
Any agent
npx skills add barateza/mcp-plesk-dev-docs --skill technical-design-doc-creator
Clone the repo
git clone --depth 1 https://github.com/barateza/mcp-plesk-dev-docs

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for technical-design-doc-creator

README.md
[![agentmods](https://agentmods.dev/badge/skills/barateza/mcp-plesk-dev-docs/technical-design-doc-creator.svg)](https://agentmods.dev/skills/barateza/mcp-plesk-dev-docs/technical-design-doc-creator)
Your own site
<a href="https://agentmods.dev/skills/barateza/mcp-plesk-dev-docs/technical-design-doc-creator"><img src="https://agentmods.dev/badge/skills/barateza/mcp-plesk-dev-docs/technical-design-doc-creator.svg" alt="Measured on agentmods" height="20"></a>
Per session 32 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 11,912 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00032 $0.11912
Opus 5 $0.00016 $0.05956
Sonnet 5 $0.00006 $0.02382
Haiku 4.5 $0.00003 $0.01191

Measured 5d ago against content hash 0ed6abc33760, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

technical-design-doc-creator scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

| **Strategies** | Approach, not commands | "Rollback via feature flag" (not the curl command) |
.github/skills/technical-design-doc-creator/SKILL.md · 1,485 lines

How it starts

The opening of the file, as written. The whole thing — 1,485 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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:

  • Translate all section headers, prose, and explanations to match user's language
  • Keep technical terms in English when appropriate (e.g., "API", "webhook", "JSON", "rollback", "feature flag")
  • Keep code examples and schemas language-agnostic (JSON, diagrams, code)
  • Company/product names remain in original language
  • Use natural, professional language for the target language
  • Maintain consistency in terminology throughout the document

Common Section Header Translations:

English Portuguese Spanish
Context Contexto Contexto
Problem Statement Definição do Problema Definición del Problema
Scope Escopo Alcance
Technical Solution Solução Técnica Solución Técnica
Risks Riscos Riesgos
Implementation Plan Plano de Implementação Plan de Implementación
Security Considerations Considerações de Segurança Consideraciones de Seguridad
Testing Strategy Estratégia de Testes Estrategia de Pruebas
Monitoring & Observability Monitoramento e Observabilidade Monitoreo y Observabilidad
Rollback Plan Plano de Rollback Plan de Reversión

Read the full file on GitHub · 1,485 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 1,485 lines · 32 tokens per session scan A 0ed6abc33760

Subscribe to this mod's changes

technical-design-doc-creator is a skill published in the GitHub repository barateza/mcp-plesk-dev-docs (2 stars, last pushed 1mo ago), licensed MIT. It adds 32 tokens to every session and 11,912 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

review-issue

Review an incoming external issue (and any gated-closed PR behind it) and decide whether to assign the contributor or decline. Use when the maintainer says "look at this issue", "review issue.

PrefectHQ/fastmcp · 44 tokens

release

Cut a FastMCP release end to end. Use when the maintainer says "cut a release", "prep a patch", "ship 4.x.y", or asks what a release would contain. Covers the notes preview, the title pun, the docs changelog PR that must land before the tag, the tag itself, the publish fan-out, and verifying gofastmcp.com actually…

PrefectHQ/fastmcp · 83 tokens

review-pr

Monitor and respond to automated PR reviews (Codex bot). Use when pushing a PR, checking review status, or responding to bot feedback. Handles the full cycle of push -> wait for review -> evaluate comments -> fix -> re-push.

PrefectHQ/fastmcp · 51 tokens

fastmcp-client-cli

Query and invoke tools on MCP servers using fastmcp list and fastmcp call. Use when you need to discover what tools a server offers, call tools, or integrate MCP servers into workflows.

PrefectHQ/fastmcp · 46 tokens

reviewing-code

Review code for quality, maintainability, and correctness. Use when reviewing pull requests, evaluating code changes, or providing feedback on implementations. Focuses on API design, patterns, and actionable feedback.

PrefectHQ/fastmcp · 43 tokens

review-security-report

Review FastMCP vulnerability reports before accepting, rejecting, patching, scoring, or publishing them. Use for security advisories, bug-bounty submissions, OAuth or MCP vulnerability claims, and proposed security fixes.

PrefectHQ/fastmcp · 46 tokens