Can I export the specifications to Confluence?

Yes, the skill provides two output options: standard Markdown for platforms like GitHub or Notion, and specific wiki markup ready to be pasted into the Confluence editor.

What specific sections does the generated document include?

The generated spec includes metadata, problem statements, goals, proposed solutions, schema/API specifications, risk assessments, and implementation plans.

Is this skill useful for existing projects?

Absolutely. It is highly effective for planning new features, refactors, or database migrations within existing codebases to ensure all technical dependencies are mapped out.

How does the interactive workflow prevent information overload?

The skill uses a four-stage process (Core Context, Solution Details, Technical Specifics, and Risks) to gather information incrementally, adapting questions based on your previous answers.

What is the Tech Spec Writer skill?

It is a specialized capability for Claude Code that helps developers create comprehensive technical specifications by guiding them through a series of targeted questions about their project goals and architecture.

Technical Specification Writer

Name: Technical Specification Writer
Author: allen-hsu

byallen-hsu

0•

Learning & Documentation

Generates comprehensive technical specification documents through a structured, interactive Q&A workflow to streamline software architecture and feature planning.

The Technical Specification Writer skill facilitates a disciplined approach to software design by guiding developers through a multi-stage interview process. It systematically gathers project context, architectural requirements, and potential risks before generating a professional-grade document. This skill ensures that critical details—such as database schema changes, API modifications, and success metrics—are fully considered before implementation begins. Supporting both Markdown and Confluence formats, it serves as an essential tool for engineering teams to maintain high documentation standards and clear communication across stakeholders.

Key Features

01Interactive multi-stage context gathering to ensure no technical detail is overlooked

02Detailed analysis of architectural impacts, including schemas, APIs, and UI flows

03Support for both GitHub-ready Markdown and Confluence wiki markup formats

04Automatic generation of structured documents based on professional tech spec templates

05Built-in risk assessment and implementation milestone planning

060 GitHub stars

Use Cases

01Standardizing technical documentation across a software engineering organization

02Creating detailed project proposals and architectural blueprints for stakeholder review

03Planning complex new features or system migrations within a development team

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