CustomAgent.app
Skill
planning
✓ Verified
Free

Technical Specification Creator

Author a technical spec document covering design, alternatives considered, trade-offs, and migration plan.

4.8(102 reviews)
39,400 installs
by GitHub

About

Produces an engineering-grade technical spec: motivation, goals, design, API, data model, alternatives considered, trade-offs, security, observability, migration plan, and rollout. The kind of doc engineers actually want to write but rarely have time for.

Tags

specdesign-docarchitectureengineering

Skill Instructions Preview

# Technical Specification

Produce an engineering spec for the target proposal.

## Sections
1. **Motivation** — why now
2. **Goals** — measurable success
3. **Non-Goals**
4. **Design** — proposed solution
5. **API / Interfaces** — exact contracts
6. **Data Model** — schemas, migrations
7. **Alternatives Considered** — what else, why not
8. **Trade-offs** — what we're giving up
9. **Security** — threats and mitigations
10. **Observability** — logs, metrics, traces
11. **Migration Plan** — how we get there safely
12. **Rollout** — feature flag, canary, percentage
13. **Open Questions**

Write for engineers who haven't seen the problem yet.

Related Skills

Skill⭐
planning
FREE

Implementation Planner

Break down a feature request into a step-by-step implementation plan with files to touch and risks identified.

planningarchitecturefeature
G
GitHub
4.9(178)
71k
★4.5k
Skill
planning
FREE

Epic Breakdown — Architecture

Decompose a large epic into architectural work items with clear interfaces, contracts, and ownership boundaries.

epicarchitectureplanning
G
GitHub
4.7(64)
28k
★1.6k
SkillNEW
security
FREE

Threat Model Analyst

Run a STRIDE-based threat modeling pass on your system architecture and surface actionable security findings.

securitystridethreat-modeling
G
GitHub
4.8(42)
13k
★980
Install
# Add as Claude Code slash command:
curl -fsSL "https://raw.githubusercontent.com/github/awesome-copilot/main/skills/create-specification/SKILL.md" \
  -o ~/.claude/commands/create-specification.md
View source on GitHub →

Compatible with

claude code

Trigger phrase

/spec
G

GitHub

@github

View on GitHub