skills.rest
qte77
qte77COMMUNITY
Explore all skills by this author →
WebsiteGitHub

generating-tech-spec

Generate MADR/ADR, RFC, and design documents from input topics.

2|1|Updated Feb 22, 2026
Search Tags:#documentation#specification#adr#rfc#generate#design-doc
One-click install
npx skills add https://github.com/qte77/claude-code-utils-plugin --skill generating-tech-spec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generating-tech-spec
Source: https://github.com/qte77/claude-code-utils-plugin/tree/main/plugins/docs-generator/skills/generating-tech-spec
Command: npx skills add https://github.com/qte77/claude-code-utils-plugin --skill generating-tech-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Automated generation of structured technical specifications (MADR/ADR, RFC, design documents, and proposals) to standardize architecture decisions and project documentation.

Core Features & Use Cases

  • Auto-detect target spec type (MADR/ADR, RFC, or design doc) from the input topic and generate the matching document.
  • Read and apply templates from references/tech-spec-formats.md to ensure proper MADR/RFC/design-doc formatting.
  • Output documents to the appropriate directories (docs/adr/, docs/rfc/, docs/specs/) with consistent naming and metadata.

Quick Start

Ask the AI to generate an ADR for a proposed API change and save it to docs/adr/.

Frequently Asked Questions about generating-tech-spec

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

FAQPage Schema
How do I generate an ADR or RFC for a proposed architecture change?▼

To generate an ADR or RFC, provide the topic to the Skill. It auto-detects the target specification type, applies formatting templates, and outputs the structured document to the appropriate directory.

What is the best way to standardize design docs across a software project?▼

Standardizing design docs requires consistent templates and storage. This Skill reads predefined format templates and outputs new documents to specific directories like docs/specs/ to ensure uniform structure.

Can I use this to create MADR formatted architecture decision records?▼

Yes, you can create MADR formatted records. The Skill preserves MADR formatting requirements by reading structural rules from its reference templates and applying them to the generated output.

Does the Skill automatically organize specifications into project directories?▼

Yes, the Skill organizes specifications automatically. It outputs generated ADRs, RFCs, and design docs to their respective directories such as docs/adr/, docs/rfc/, and docs/specs/.

When do I need to generate a formal technical specification document?▼

You need a formal technical specification when standardizing architecture decisions, API designs, or project governance. The Skill generates structured proposals to document these engineering decisions consistently.

Related Skills

Explore More Software Engineering Skills→
joestumpjoestump
30

prime

Load ADR and openspec documents into conversational context with semantic topic filtering.

Community
Intermediate
ccfccf

architecture-decision-records

Document architectural decisions with a MADR-style template and lifecycle.

Community
Advanced
zzafergokzzafergok
1

markdown-to-html-skill

Convert Markdown documents to HTML using marked.js, pandoc, gomarkdown, or static site generators.

Community
Intermediate
oiagorodriguesoiagorodrigues

create-rfc

Generate RFC documents with required decision fields and structured sections.

Community
Advanced