Spec Kit — Spec-Driven Dev Toolkit from GitHub, 85K Stars

What it is

Spec Kit is an open-source toolkit from GitHub for spec-driven development. Instead of giving AI agents vague instructions (vibe coding), you write structured product specifications and use the specify CLI to turn them into planned, executable tasks. The tool bridges the gap between product requirements and AI-assisted code generation.

Spec Kit targets engineering teams and individual developers who want more control over AI-generated code. By writing specs first, you get predictable outputs from AI agents rather than hoping the agent interprets your intent correctly.

How it saves time or tokens

Spec-driven development reduces the back-and-forth between you and your AI agent. Instead of iterating on vague prompts, you define what you want upfront in a structured spec. The specify CLI breaks specs into discrete tasks that agents can execute sequentially. This approach minimizes wasted tokens on misunderstood requirements and produces more consistent results.

How to use

1. Install the specify CLI: uv tool install specify-cli --from git+https://github.com/github/spec-kit.git.
2. Initialize a project with specify init my-project to create the spec directory structure.
3. Write a spec document, run specify plan to generate tasks, and execute them with your AI agent.

Example

# Install the CLI
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

# Initialize a project
specify init my-project
cd my-project

# Create a spec
specify new feature-login

# Plan tasks from the spec
specify plan feature-login

# Execute with your AI agent
specify run feature-login

Related on TokRepo

• Coding AI Tools — AI-powered development tools and workflows
• Prompt Library — Structured prompts and skills for AI agents

Common pitfalls

• Spec Kit requires well-written specifications to be effective. Vague specs produce vague task plans. Invest time in clear requirement writing.
• The tool works best with agents that support structured task execution. Not all AI coding agents integrate equally well.
• Spec Kit is relatively new. The CLI interface and spec format may change between releases. Pin your version for production workflows.