Technical Specification

This is your structured approach to writing specs that won't get you lost three sprints in. It gives you a markdown template covering requirements, architecture, API design, database schemas, and testing strategy. Everything is organized into tables with priority levels and risk assessments. The template includes non-functional requirements with actual numbers (99.9% uptime, 200ms response time) instead of hand-wavy "should be fast" statements. Use it when you need to document a feature properly before building it, or when you're tired of specs that skip over the hard questions like rollback plans and security considerations. It's opinionated about what goes where, which is the point.

skills.sh installs: 489
GitHub stars: 248
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add secondsky/claude-skills --skill technical-specification --agent claude-code

Installs into .claude/skills of the current project.

Files

Technical Specification

Create comprehensive technical specifications for software projects.

Specification Template

# Technical Specification: [Feature Name]

## Metadata
- **Status**: Draft | In Review | Approved
- **Author**: [Name]
- **Reviewers**: [Names]
- **Last Updated**: [Date]

## Executive Summary
[2-3 sentences: What problem does this solve? What's the proposed solution?]

## Background & Context
- Current pain points
- Why now?
- Related work

## Goals
### Primary Goals
1. [Measurable goal]

### Non-Goals
- [What this spec explicitly does NOT cover]

## Functional Requirements
| ID | Requirement | Priority |
|----|-------------|----------|
| FR-1 | [Description] | P0 |
| FR-2 | [Description] | P1 |

## Non-Functional Requirements
- **Performance**: Response time < 200ms
- **Scalability**: Support 10K concurrent users
- **Availability**: 99.9% uptime
- **Security**: [Requirements]

## Technical Design

### Architecture
[Diagram or description]

### API Design

POST /api/v1/resource Request: { "field": "value" } Response: { "id": "123", "field": "value" }

SKILL.md on GitHub