How does it handle unresolved technical questions?

After generating a draft, the skill identifies 'Open Questions,' presents them to the user for clarification, and updates the specification based on the user's feedback.

What is the create-spec skill?

It is a Claude Code capability that generates detailed technical design documents (RFCs) by analyzing existing research documents within your codebase's research directory.

What is the output format of the specification?

The specification is generated as a structured Markdown file (.md) following a professional technical design template and is saved in the specs/ directory.

Does this skill actually implement the features?

No, this specific skill focuses entirely on the planning and design phase; it creates a comprehensive blueprint for implementation without modifying the source code.

Where does the skill look for information?

By default, it searches the research/ directory for relevant findings to inform the specification. It specifically avoids looking in the specs/ directory to prevent circular logic.

Technical Spec Architect

Name: Technical Spec Architect
Author: flora131

byflora131

•

Productivity & Workflow

Generates comprehensive technical design documents and RFCs by synthesizing codebase research into actionable implementation plans.

The Technical Spec Architect skill streamlines the transition from research to implementation by generating detailed, template-driven design documents. It leverages findings from the research directory to create structured RFCs (Requests for Comments) covering system architecture, data models, and API interfaces. This skill ensures architectural consistency, forces the consideration of trade-offs, and includes an interactive loop to resolve open questions with the user before finalizing the plan, making it an essential tool for planning complex features or major refactors within any codebase.

Key Features

01Automated synthesis of research documents from the research directory

02Standardized system architecture diagrams using Mermaid syntax

03Interactive resolution of open questions and architectural edge cases

04Comprehensive coverage of security, observability, and migration strategies

05Template-driven RFC generation based on industry standards

0689 GitHub stars

Use Cases

01Drafting formal RFCs for new system features or microservices

02Creating standardized technical documentation for team-wide architectural reviews

03Planning complex codebase refactors with documented technical trade-offs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add flora131/atomic create-spec

For use in Claude.ai and ChatGPT

Download Skill