Can I use this for API and database changes?

Absolutely. The workflow includes dedicated stages for schema specifications (tables/fields) and API changes (endpoints/methods) to ensure technical depth.

Does it help with risk assessment?

Yes, the Stage 4 questioning specifically focuses on identifying known risks, technical challenges, and key metrics to ensure a robust implementation plan.

How does the interactive Q&A work?

Claude will ask questions in stages (Core Context, Solution, Technical Specifics, and Risks) to avoid overwhelming you, adapting the questions based on your previous answers.

What output formats does the Tech Spec Writer support?

The skill provides two primary formats: clean Markdown (ideal for GitHub, Notion, or Obsidian) and Confluence wiki markup for seamless integration into enterprise documentation.

Tech Spec Writer

Name: Tech Spec Writer
Author: allen-hsu

byallen-hsu

0•

内容管理

Generates comprehensive technical specification documents through a structured, interactive Q&A workflow.

Tech Spec Writer is a specialized utility for Claude Code designed to streamline the technical planning phase of software development. By guiding users through a four-stage discovery process—covering core context, solution details, technical specifics, and risk management—it gathers all necessary information before generating a professional specification document. This skill ensures that engineering teams maintain high documentation standards for new features, architectural changes, and API updates, providing output in both standard Markdown and Confluence-ready wiki markup.

主要功能

010 GitHub stars

02Interactive 4-stage context gathering workflow

03Automated generation of structured technical specifications

04Support for both Markdown and Confluence wiki markup formats

05Deep-dive technical sections for API, schema, and UI changes

06Comprehensive risk assessment and implementation planning templates

使用场景

01Creating architectural proposals for stakeholder review

02Standardizing technical documentation across an engineering team

03Planning and documenting a new complex software feature

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add allen-hsu/claudekit tech-spec-writer

For use in Claude.ai and ChatGPT

Download Skill