spec

Draft technical specifications covering requirements, design, APIs, and testing criteria.

1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/aronpc/ai --skill spec-aronpc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/aronpc/ai/tree/main/skills/spec
Command: npx skills add https://github.com/aronpc/ai --skill spec-aronpc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured approach to composing comprehensive technical specifications, including requirements, design, APIs, and tests, ensuring clear communication and alignment across stakeholders.

Core Features & Use Cases

  • Requirements gathering: Define functional and non-functional requirements with acceptance criteria.
  • Technical design: Outline architecture, data models, API contracts, and UI/UX considerations.
  • Verification & testing: Include testing strategy and milestones to validate requirements.
  • Use Case: When planning a new feature, generate a complete spec doc to feed implementation, reviews, and QA.

Quick Start

Create a new spec.md and fill in problem, goals, architecture, requirements, design, and tests.

Frequently Asked Questions about spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write technical specifications for cross-functional feature planning?▼

To write technical specifications, define the problem statement, functional and non-functional requirements, architectural design, API contracts, and testing criteria to ensure alignment across product, design, and engineering teams.

What should be included in a technical spec document for API contracts and architecture?▼

A technical spec document should include problem statements, design decisions, data models, API contracts, UI/UX considerations, acceptance criteria, risk assessment, and open questions for comprehensive feature planning.

How do I structure requirements gathering and QA planning for a new software feature?▼

Structure requirements gathering by defining functional and non-functional requirements with acceptance criteria, then outline a verification and testing strategy including milestones to validate those requirements for QA planning.

Can I use this approach to define both functional and non-functional requirements with acceptance criteria?▼

Yes, this approach specifically supports defining both functional and non-functional requirements, establishing clear acceptance criteria, and documenting constraints to guide implementation and reviews.

What is the best way to document design decisions and testing criteria for engineering teams?▼

The best way to document design decisions is creating a structured spec file that captures architecture, API contracts, testing strategy, and milestones, ensuring clear communication across stakeholders.