keel

Keel

A seven-command lifecycle that carries a change from raw idea to merge, for AI coding agents.

Every skill's content — the workflows, checklists, and engineering judgment — was written by Addy Osmani and the original contributors. This fork doesn't change what the skills teach. It reorganizes how you reach them: 24 loosely-connected skills become a six-phase lifecycle (keel-interview → keel-spec → keel-plan → keel-build → keel-test → keel-review), plus keel-simplify as a run-anytime utility, with the specialist skills wired in as on-demand call-ins instead of a flat list you have to memorize. Same discipline, easier to actually use.

This is a fork. Keel (repo: korflux/keel-skills) is a personal adjustment of the original Addy Osmani / agent-skills project, maintained by @korflux. All skill design and workflow content are the work of Addy Osmani and the original contributors (see Credits) — this fork renames commands so the same short name works the same way in Claude Code, Grok Build, Antigravity, and Codex, drops the persona//ship layer in favor of on-demand skills wired directly into the lifecycle commands, and organizes the catalog around the seven-command flow above. For the canonical, full-featured upstream project, go to addyosmani/agent-skills.

 INTERVIEW        DEFINE          PLAN           BUILD          TEST          REVIEW
 ┌────────┐    ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐
 │ Extract│───▶│ Spec │ ───▶ │ Plan │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │  QA  │
 │ intent │    │  PRD │      │ Tasks│      │ Impl │      │Debug │      │ Gate │
 └────────┘    └──────┘      └──────┘      └──────┘      └──────┘      └──────┘
/keel-interview /keel-spec    /keel-plan    /keel-build   /keel-test    /keel-review

---

Commands

7 slash commands: the 6-phase lifecycle, plus /keel-simplify as a standalone utility you can run any time.

What you're doing	Command	Key principle
Find out what's actually wanted	/keel-interview	Ask before you assume
Define what to build	/keel-spec	Spec before code
Plan how to build it	/keel-plan	Small, atomic tasks
Build incrementally	/keel-build	One slice at a time
Prove it works	/keel-test	Tests are proof
Review before merge	/keel-review	Improve code health
Simplify the code	/keel-simplify	Clarity over cleverness

Want fewer manual steps once the spec exists? /keel-build auto generates the plan and implements every task in a single approved pass — you approve the plan once, then it runs autonomously. It removes the human stepping between tasks, not the verification: every task is still test-driven and committed individually, and it pauses on failures or risky steps.

Every command file already carries the keel- prefix, so the same short name works whether your CLI resolves it as a slash command or as a $skill reference — no per-tool renaming needed to dodge collisions.

Command syntax by tool

Once a command is loaded (see Install below), the invocation looks almost identical across tools because the command name itself carries the brand prefix:

Command	Claude Code	Grok Build	Antigravity	Codex
Interview	/keel-interview	/keel-interview	/keel-interview	$keel-interview
Spec	/keel-spec	/keel-spec	/keel-spec	$keel-spec
Plan	/keel-plan	/keel-plan	/keel-plan	$keel-plan
Build	/keel-build	/keel-build	/keel-build	$keel-build
Test	/keel-test	/keel-test	/keel-test	$keel-test
Review	/keel-review	/keel-review	/keel-review	$keel-review
Simplify	/keel-simplify	/keel-simplify	/keel-simplify	$keel-simplify

Codex has no slash-command concept at all — its plugin manifest has no commands field, so a skill is invoked with $name instead. Claude Code and Grok Build support a qualified keel:keel-spec form if you ever need to disambiguate against another installed plugin, but day to day the unqualified /keel-spec is what you'll type.

---

Install

Recommended — verified, works with 70+ agents, no plugin registration needed. The skills CLI clones this repo and drops the skills you pick into whichever agent(s) it detects on your machine (Claude Code, Cursor, Codex, Copilot, Cline, and more):