Agent skill · software engineering · secondsky
technical-specification
Creates detailed technical specifications for software projects covering requirements, architecture, APIs, and testing strategies. Use when planning features, documenting system design, or creating architecture decision records.
Why this skill is useful
Provides a structured template for creating technical specifications that includes domain-specific requirements and best practices not commonly known to the AI.
What it needs
About 2k tokens when loaded. Last updated 2026-08-06. 204 stars on the source repository.
What this skill does
Technical Specification Create comprehensive technical specifications for software projects. Specification Template POST /api/v1/resource Request: { "field": "value" } Response: { "id": "123", "field": "value" } sql CREATE TABLE resources ( id UUID PRIMARY KEY, field VARCHAR(255) ); Full Template See references/template.md for a comprehensive copy-paste template including: Complete metadata section Success metrics tables Architecture diagrams Detailed API design sections Security threat analysis Monitoring & observability Risk assessment matrix Rollout and rollback plans Dependencies tracking Open questions section Best Practices Do: Include measurable acceptance criteria Add architecture diagrams Define explicit API contracts Quantify performance targets Document risks and mitigations Get stakeholder review before implementation Include security considerations Define rollback procedures Don't: Use vague requirements ("fast", "scalable") Skip non-functional requirements Ignore security considerations Leave alternatives unexplored Omit testing strategy Forget dependencies and risks
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills secondsky/technical-specification