Agent skill · writing content · aj-geddes
technical-specification
Create detailed technical specifications, requirements documents, design documents, and system architecture specs. Use when writing technical specs, requirements docs, or design documents.
Why this skill is useful
Codifies a structured approach to creating technical specifications that the AI could infer but now doesn't have to guess.
What it needs
About 1k tokens when loaded. Last updated 2026-03-04. 307 stars on the source repository.
What this skill does
Technical Specification Table of Contents Overview When to Use Quick Start Reference Guides Best Practices Overview Create comprehensive technical specifications that define system requirements, architecture, implementation details, and acceptance criteria for software projects. When to Use Feature specifications System design documents Requirements documentation (PRD) Architecture decision records (ADR) Technical proposals RFC (Request for Comments) API design specs Database schema designs Quick Start Minimal working example: Reference Guides Detailed implementations in the references/ directory: Guide Contents --- --- Functional Requirements Functional Requirements Non-Functional Requirements Non-Functional Requirements Database Schema Database Schema API Data Models API Data Models Authentication Endpoints Authentication Endpoints Rate Limiting Rate Limiting Phase 1: Core Authentication Phase 1: Core Authentication (Week 1-2), Phase 2: Email Verification (Week 3), Phase 3: Social Login (Week 4), Phase 4: Security Features (Week 5) (+1 more) Best Practices ✅ DO Include acceptance criteria for each requirement Provide architecture diagrams Document API contracts Specify performance requirements List risks and mitigations Include implementation timeline Add success metrics Document security considerations Version your specs Get stakeholder review ❌ DON'T Be vague about requirements Skip non-functional requirements Forget about security Ignore alternatives Skip testing strategy Forget monitoring/observability Leave questions unanswered
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aj-geddes/technical-specification