specify

Converts design documents into technical specifications with data models and API contracts.

2|1|Updated Jul 2, 2025
One-click install
npx skills add https://github.com/rikdc/claude_code_template --skill specify
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: specify
Source: https://github.com/rikdc/claude_code_template/tree/main/.claude/skills/specify
Command: npx skills add https://github.com/rikdc/claude_code_template --skill specify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts high-level design concepts into precise, unambiguous technical specifications that developers can implement directly, reducing ambiguity and rework.

Core Features & Use Cases

  • Structured Spec Generation: Translates requirements, architectures, and design documents into formal specs including functional and non-functional requirements, data models, and API contracts.
  • Consistency & Traceability: Maintains traceability from requirements to implementation, with validation criteria and acceptance metrics.
  • Use Case: Given a design document for a new REST API, generate endpoints, data models, error handling, and example payloads ready for implementation.

Quick Start

/specify /specify <design_doc> /specify --api <service> /specify --data <entity> /specify --integration <service>

Frequently Asked Questions about specify

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

FAQPage Schema
How do I convert a design document into a technical specification?▼

Convert design documents into precise technical specifications by translating high-level concepts into structured requirements, API contracts, data models, and validation criteria that developers can implement directly without ambiguity.

What should a technical specification include for API development?▼

A technical specification for APIs must include endpoints, request/response data models, error handling, validation rules, non-functional requirements like performance and security, and example payloads ready for implementation.

How do I maintain traceability from requirements to implementation?▼

Maintain traceability by documenting functional and non-functional requirements, component interfaces, acceptance metrics, and validation criteria within the specification so every implementation decision traces back to requirements.

Can I generate specifications for data models and integrations?▼

Yes, this Skill generates specifications for data models, integration services, and architecture designs by structuring entity definitions, relationships, validation rules, and integration contracts into implementable specs.

What's the difference between a design document and a technical specification?▼

Design documents communicate concepts and decisions at a high level, while technical specifications translate those into precise, unambiguous functional and non-functional requirements with data models, interfaces, and acceptance criteria ready for code.