tech-spec-writer

Generate structured technical specification documents from interactive Q&A workflows.

1|Updated Dec 31, 2025
One-click install
npx skills add https://github.com/allen-hsu/arsenal --skill tech-spec-writer-allen-hsu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-spec-writer
Source: https://github.com/allen-hsu/arsenal/tree/main/plugins/tech-lead/skills/tech-spec-writer
Command: npx skills add https://github.com/allen-hsu/arsenal --skill tech-spec-writer-allen-hsu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Writing comprehensive technical specifications is time-consuming and error-prone when done manually, especially for complex features and architecture.

Core Features & Use Cases

  • Interactive Q&A workflow to gather context before drafting the spec.
  • End-to-end support from problem statement to implementation plan using templates and references.
  • Generates a complete Tech Spec in standard templates (Metadata, Problem Statement, Goals, Changes, API/Schema specs, UI flows) with optional Confluence-ready outputs.

Quick Start

Describe a feature and let the Tech Spec Writer generate a full specification draft.

Frequently Asked Questions about tech-spec-writer

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

FAQPage Schema
How do I write a technical specification document for a complex feature?

A technical specification is generated through an interactive Q&A workflow that gathers context to produce structured drafts covering problem statements, goals, API schemas, and UI flows. This enforces documentation best practices and ensures complete coverage for complex features.

What should be included in a tech spec for architecture changes?

A tech spec for architecture changes should include metadata, problem statements, goals, detailed changes, API or schema specifications, and UI flows. Using standard templates ensures all stakeholders understand the implementation plan and feature planning requirements.

Can I generate Confluence-ready outputs for my feature planning documentation?

Yes, you can generate Confluence-ready outputs for feature planning documentation. The workflow produces complete technical specifications in standard templates that can be exported directly for stakeholder review and architecture documentation.

What is the best way to gather requirements from stakeholders for a tech spec?

The best way to gather requirements from stakeholders is through a guided interactive Q&A workflow. It asks targeted questions and applies templates to capture the necessary context before drafting the technical specification, reducing manual errors.

Does automated tech spec generation work for end-to-end feature planning?

Automated tech spec generation supports end-to-end feature planning from problem statement to implementation plan. It guides the context gathering process and applies references to enforce best practices, ensuring complete architecture and schema documentation.