tech-spec-writing

What problem does it solve?

This Skill helps you create detailed technical specifications (design docs, RFCs) for significant technical projects, ensuring clarity on problem statements, requirements, design options, trade-offs, and decisions.

Core Features & Use Cases

• Structured Template: Provides a comprehensive template covering problem statement, goals, requirements, design, alternatives, implementation, testing, and observability.
• Guidance on When to Spec: Offers clear criteria for when a technical spec is necessary versus when it can be skipped.
• Writing Best Practices: Includes tips for effective spec writing, such as focusing on the problem first, considering alternatives, and making decisions explicit.
• Use Case: When starting a new microservice that will impact multiple teams, use this skill to generate a detailed technical specification that outlines the API, data model, and rollout plan.

Quick Start

Use the tech-spec-writing skill to draft a technical specification for a new user authentication service.