tech-spec-gen

Converts design documents into structured AI-ready technical specifications with Given-When-Then acceptance criteria, API definitions, and tech-spec.md output.

19|3|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/miles990/claude-domain-skills --skill tech-spec-gen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-spec-gen
Source: https://github.com/miles990/claude-domain-skills/tree/main/methodology/tech-spec-gen/skills/tech-spec-gen
Command: npx skills add https://github.com/miles990/claude-domain-skills --skill tech-spec-gen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design documents like GDD/PRD/FRD can be transformed into AI-executable technical specifications, reducing handoff gaps between design and engineering.

Core Features & Use Cases

  • Generate structured tech specs including architecture, API definitions, data models, and acceptance criteria from design artifacts.
  • Support multiple doc formats (GDD, PRD, FRD, SDD, generic) and produce consistent spec outputs ready for implementation.
  • Use case: Given a design document for a module, convert it into a ready-to-implement tech-spec.md and task artifacts for the development pipeline.

Quick Start

Provide a path to a design document to generate a complete tech-spec and associated tasks.

Frequently Asked Questions about tech-spec-gen

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

FAQPage Schema
How do I convert a PRD into a technical specification for development?

To convert a PRD into a technical specification, provide the design document path to generate structured tech specs. The process outputs a ready-to-implement tech-spec.md file containing architecture, API definitions, data models, and acceptance criteria.

What is the best way to generate Given-When-Then acceptance criteria from design docs?

Generating Given-When-Then acceptance criteria from design docs is automated by transforming GDD, PRD, or FRD files into structured technical specifications. This enforces behavior-driven development standards directly within the generated tech-spec.md output.

Can I use a generic design document to generate API definitions and data models?

Yes, you can use a generic design document to generate API definitions and data models. The conversion process supports multiple formats including GDD, PRD, FRD, SDD, and generic docs, producing consistent specification artifacts for implementation.

Does tech-spec-gen support generating Architecture Decision Records from an FRD?

Generating Architecture Decision Records (ADRs) from an FRD is supported by transforming functional requirement documents into executable technical specifications. The output includes ADRs alongside API definitions and implementation task artifacts.

How do I create executable task artifacts from a software design document?

To create executable task artifacts from a software design document, input the SDD file path for processing. The system generates structured tech specs and associated task outputs ready for the development pipeline implementation.

What limitations exist when transforming design documents into implementation guidance?

When transforming design documents into implementation guidance, the primary limitation is the dependency on the input quality of the provided GDD, PRD, or FRD. The generated technical specification requires no external dependencies but relies entirely on the source document's clarity.