spec

Generate feature and bugfix specs with AGENTS.md domain documentation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/swtch1/dotfiles --skill spec-swtch1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/swtch1/dotfiles/tree/main/.claude/skills/spec
Command: npx skills add https://github.com/swtch1/dotfiles --skill spec-swtch1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the creation of detailed specifications for software features and bugfixes, ensuring clarity for both human reviewers and AI coding agents, and maintains living documentation for code modules.

Core Features & Use Cases

  • Spec Generation: Creates feature and bugfix specifications using templates, incorporating user input and codebase context.
  • Domain Documentation: Generates and maintains AGENTS.md files for per-directory module documentation.
  • Workflow Integration: Guides users through a structured process of gathering context, probing for issues, and drafting specifications.
  • Use Case: When starting a new feature, use this Skill to generate a comprehensive spec that outlines the problem, solution, technical approach, and verification steps, ensuring all stakeholders are aligned before development begins.

Quick Start

Use the spec skill to create a new feature specification for the user authentication module.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I generate feature specifications for AI coding agents?

Feature specifications for AI coding agents are generated using structured templates that incorporate user input and codebase context. The skill guides users through context gathering, discovery probing, and drafting to ensure clarity for human reviewers and AI agents.

What is spec-driven development and when do I need it for my workflow?

Spec-driven development is the process of creating detailed specifications before implementation begins. You need it when starting new features or bugfixes to outline the problem, solution, technical approach, and verification steps, ensuring stakeholders are aligned before development.

How do I maintain living domain documentation for my code modules?

Living domain documentation for code modules is maintained by generating and updating AGENTS.md files on a per-directory basis. This provides per-directory module documentation that stays current as codebases evolve.

Can I manage bugfix specifications and track implementation deltas?

Yes, bugfix specifications are supported with full lifecycle management including implementation deltas and verification checks. The skill guides users through structured draft generation to track changes and verify fixes effectively.

Does spec-driven development work without external dependencies?

Yes, spec-driven development works without external dependencies, as the skill operates independently using built-in scripts, assets, and reference templates. It requires no additional frameworks to generate specifications or AGENTS.md documentation.