How does the skill handle file naming and numbering?

The skill automatically scans your docs directory to find the next available sequence number for ADRs and RFCs (e.g., 0004-slug.md) or uses date-based prefixes for design specs.

Does it provide templates for the documents?

Yes, it references specific markdown templates for each document type to ensure consistent structure, including context, decision, and consequences sections.

Can this skill overwrite my existing documentation?

No, the skill includes a safety rule that prevents overwriting existing files; it always creates new documents to ensure your history remains intact.

What document formats does this skill support?

It supports Architectural Decision Records (ADR) using the MADR format, Request for Comments (RFC), Design Documents, and Technical Proposals.

Technical Specification Generator

Name: Technical Specification Generator
Author: qte77

byqte77

0•

Learning & Documentation

Generates structured architectural decision records, RFCs, and design documents using standardized templates and sequential numbering.

The Technical Specification Generator is a professional documentation tool for Claude Code designed to streamline the engineering design process. It automates the creation of Architectural Decision Records (ADR) in MADR format, Request for Comments (RFC), and comprehensive design documents by applying industry-standard templates and consistent naming conventions. By scanning existing project documentation, the skill ensures correct sequential numbering and YAML frontmatter, allowing developers to focus on technical content while maintaining a rigorous and searchable project history.

Key Features

01Support for ADR (MADR), RFC, Design Docs, and Technical Proposals

02Pre-configured templates for consistent architectural documentation

03Automatic YAML frontmatter generation for status and metadata tracking

04Automatic sequential numbering and standardized slug-based file naming

05Intelligent context gathering via integrated WebSearch and WebFetch

060 GitHub stars

Use Cases

01Recording a permanent architectural decision with context and consequences

02Drafting a formal RFC to propose and discuss system-wide changes

03Creating detailed technical design documents for complex feature implementations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add qte77/claude-code-utils-plugin generating-tech-spec

For use in Claude.ai and ChatGPT

Key Features

01Support for ADR (MADR), RFC, Design Docs, and Technical Proposals

02Pre-configured templates for consistent architectural documentation

03Automatic YAML frontmatter generation for status and metadata tracking

04Automatic sequential numbering and standardized slug-based file naming

05Intelligent context gathering via integrated WebSearch and WebFetch

060 GitHub stars

Use Cases

01Recording a permanent architectural decision with context and consequences

02Drafting a formal RFC to propose and discuss system-wide changes

03Creating detailed technical design documents for complex feature implementations

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add qte77/claude-code-utils-plugin generating-tech-spec

For use in Claude.ai and ChatGPT