Technical Specification

A structured approach to writing technical specs that covers everything from PRDs to ADRs. You get templates for functional and non-functional requirements, API contracts, database schemas, and phased implementation timelines. The framework pushes you to document acceptance criteria, security considerations, and success metrics upfront, which honestly saves you from those "wait, what were we building again?" moments three weeks into development. Includes practical sections for risks, alternatives, and monitoring strategy. If you're tired of half-baked specs that leave critical decisions undocumented, this gives you a repeatable structure that actually gets stakeholder buy-in before code gets written.

skills.sh installs: 811
GitHub stars: 379
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aj-geddes/useful-ai-prompts --skill technical-specification --agent claude-code

Installs into .claude/skills of the current project.

Files

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:

# Technical Specification: [Feature Name]

**Document Status:** Draft | Review | Approved | Implemented
**Version:** 1.0
**Author:** John Doe
**Date:** 2025-01-15
**Reviewers:** Jane Smith, Bob Johnson
**Last Updated:** 2025-01-15

## Executive Summary

Brief 2-3 sentence overview of what this spec covers and why it's being built.

**Problem:** What problem are we solving?
**Solution:** High-level description of the solution
**Impact:** Expected business/user impact

---

## 1. Background

### Context

SKILL.md on GitHub

Details

Repository: github.com/aj-geddes/useful-ai-prompts
Categories: Documentation, Code Review & Quality, AI & Agent Building, Design & UI/UX
First seen: May 16, 2026

humanizer-cnz0gsh1u/oh-my-writing-skill识别并消除中文文本中的 AI 生成痕迹，使文章更自然、更像人类创作。基于中文语境的 AI 写作特征检测，包括套话、过度修饰、机械结构等。参考 Wikipedia "Signs of AI writing" 指南，并针对中文进行本地化。803skills.sh installs

openapi-specification-v2hairyf/skillsOpenAPI (Swagger) 2.0 specification for describing REST APIs. Use when writing, validating, or interpreting Swagger 2.0 specs, generating clients/docs, or worki781skills.sh installs

howto-section-generatorkostja94/marketing-skillsWhen the user wants to create, optimize, or audit a HowTo section block—an in-page block of ordered steps with optional Schema.org HowTo JSON-LD. Also use when 763skills.sh installs

code-tourgithub/awesome-copilotUse this skill to create CodeTour .tour files — persona-targeted, step-by-step walkthroughs that link to real files and line numbers. Trigger for: "create a tou739skills.sh installs

codebase-onboardingalirezarezvani/claude-skillsAnalyze a codebase and generate onboarding documentation for engineers, tech leads, and contractors. Fast fact-gathering and repeatable onboarding outputs. Use 727skills.sh installs

content-productionalirezarezvani/claude-skillsFull content production pipeline — takes a topic from blank page to published-ready piece. Use when you need to execute content: write a blog post, article, or 726skills.sh installs

Technical Specification

Install

Files

Technical Specification

Table of Contents

Overview

When to Use

Quick Start

Details

More from aj-geddes/useful-ai-prompts

Recommended