Skip to content

/spec

Start spec-driven development — write a structured specification before writing code

From plugin
agent-skills
117k9 skills4 agents9 commands7 hooks
> /plugin marketplace add addyosmani/agent-skills
> /plugin install agent-skills@addy-agent-skills

Command definition

spec.md
description: Start spec-driven development — write a structured specification before writing code
disable-model-invocation: true

Invoke the agent-skills:spec-driven-development skill.

First check whether SPEC.md already exists in the project root — that decides which flow applies.

**New spec** (no SPEC.md, or the request is unrelated to what it describes): Begin by understanding what the user wants to build. Ask clarifying questions about: 1. The objective and target users 2. Core features and acceptance criteria 3. Tech stack preferences and constraints 4. Known boundaries (what to always do, ask first about, and never do)

Then generate a structured spec covering all six core areas: objective, commands, project structure, code style, testing strategy, and boundaries.

If the request bundles several independently testable capabilities, first propose a capability map (module ids, dependency direction, build order) per the skill's Phase 0 and get it approved, then spec each module in dependency order.

Save the spec as SPEC.md in the project root and confirm with the user before proceeding.

**Delta spec** (SPEC.md exists and this request is a change to what it describes): do not overwrite it — write a delta spec (e.g. SPEC-<change-slug>.md) covering only the change, per the skill's Spec Evolution section, and confirm with the user before proceeding.

@addyosmani
Ships withagent-skills

Production-grade engineering skills for AI coding agents. Skills encode the workflows, quality gates, and best practices that senior engineers use when building software.

Stars on GitHub

Momentum

stars in total
117.2k
Star history of addyosmani/agent-skills on GitHub, a chart by star-history.com

Other commands on agent-skills.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

plan
Auto-invoked

plan

Command

Break work into small verifiable tasks with acceptance criteria and dependency ordering

review
Auto-invoked

review

Command

Conduct a five-axis code review — correctness, readability, architecture, security, performance

ship
Auto-invoked

ship

Command

Run the pre-launch checklist via parallel fan-out to specialist personas, then synthesize a go/no-go decision

More commands from other plugins.

audit-codebase

audit-codebase

Command

RTK Codebase Health Audit — 7 catégories scorées 0-10

rtk4d86k
@rtk-ai@rtk-aiInstall Command