When should I use the tech-spec-writing skill?

Use it for projects lasting more than one sprint, involving multiple engineers, changing architecture, or modifying shared API contracts.

Can I use this for RFCs?

Absolutely. The template is designed to function as an RFC (Request for Comments), featuring an 'Alternatives Considered' section to facilitate technical debate.

Does the template include non-functional requirements?

Yes, it includes specific sections for latency, throughput, availability, data retention, security, and observability.

What is a technical specification?

A technical specification is a document detailing the design, requirements, and implementation plan for a software project to ensure team alignment before coding begins.

How does this skill help with engineering efficiency?

It front-loads critical design decisions and trade-off analysis, preventing costly mid-project pivots and ensuring all stakeholders agree on the approach.

Technical Spec Writing Assistant

Name: Technical Spec Writing Assistant
Author: chavangorakh1999

bychavangorakh1999

0•

Learning & Documentation

Generates comprehensive technical specifications and design documents to guide complex software engineering projects.

This skill helps software engineers and architects produce high-quality technical specifications, RFCs, and design documents. It guides users through a structured framework—from framing the problem and setting goals to analyzing alternatives and planning rollouts. By standardizing the documentation process, it ensures that technical decisions are well-reasoned, stakeholders are aligned, and complex systems are built with a clear roadmap, ultimately reducing technical debt and scope creep.

Key Features

01Guidelines for defining functional and non-functional requirements

020 GitHub stars

03Standardized RFC and design document templates

04Framework for trade-off and alternatives analysis

05Structured implementation and rollout planning

06Integrated best practices for technical communication

Use Cases

01Proposing breaking changes to cross-team API contracts

02Evaluating and documenting trade-offs between different technical solutions

03Drafting a design doc for a new architectural component

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add chavangorakh1999/sde-skills tech-spec-writing

For use in Claude.ai and ChatGPT

Key Features

01Guidelines for defining functional and non-functional requirements

020 GitHub stars

03Standardized RFC and design document templates

04Framework for trade-off and alternatives analysis

05Structured implementation and rollout planning

06Integrated best practices for technical communication

Use Cases

01Proposing breaking changes to cross-team API contracts

02Evaluating and documenting trade-offs between different technical solutions

03Drafting a design doc for a new architectural component

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add chavangorakh1999/sde-skills tech-spec-writing

For use in Claude.ai and ChatGPT