Keystone Spec
Capture intent + acceptance criteria for a unit of work. First action on any task. Triggers: keystone spec; keystone:spec; /keystone:spec; capture acceptance criteria; spec this task; what are we building.
Install
npx skills add tacoda/keystone --skill keystone-specgit clone --depth 1 https://github.com/tacoda/keystone.git /tmp/keystone
mkdir -p ~/.claude/skills
cp -r /tmp/keystone/.agents/skills/keystone-spec ~/.claude/skills/keystone-specPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# keystone:spec — capture intent + AC Phase 1 of the six-phase lifecycle. Forces the agent to write down what "done" looks like before any code is touched. Output lands in the task notes / PR description / equivalent — acceptance criteria the agent and user both sign off on. Full discipline at `.agents/rules/process/spec.md`. ## Run **Capture intent and acceptance criteria** for a unit of work. First command on any task. Read [`.agents/rules/process/spec.md`](../../rules/process/spec.md) for the full discipline. ## Inputs - A tracker card ID (Jira / Linear / GitHub Issues / Asana), **or** - A conversation describing the work, **or** - A `TODO.md` entry. If a tracker card was named, fetch its description via whatever tooling the agent has (MCP server, `gh issue view`, `jira` CLI, web fetch). Copy any acceptance criteria into the spec. ## Activities 1. **Restate the intent** in your own words. 2. **List acceptance criteria** — explicit, testable bullets a reviewer can verify objectively. 3. **List non-goals** — what is *not* in scope, to prevent feature creep. 4. **Flag uncertainty** — open questions the user must answer before planning. 5. **Save the spec** to `docs/specs/YYYY-MM-DD-<topic>.md` with the frontmatter shape described in `.agents/rules/process/spec.md` (if the project has that location; otherwise capture inline in the chat). ## Gate Do not proceed to planning until the user has explicitly accepted the spec. ## Iron law
Details
- Skill name
keystone-spec- Repository
- tacoda/keystone
- Path
.agents/skills/keystone-spec/SKILL.md- License
- MIT
- Repo updated
- 17 November 2026
FAQ
What does the Keystone Spec skill do?
Capture intent + acceptance criteria for a unit of work. First action on any task. Triggers: keystone spec; keystone:spec; /keystone:spec; capture acceptance criteria; spec this task; what are we building.
How do I install the Keystone Spec skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add tacoda/keystone --skill keystone-spec. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Keystone Spec popular?
It lives in tacoda/keystone, which has 44 GitHub stars and 3 forks.
Related skills
Keystone Allocate
44tacoda/keystone
Move an existing agent setup into the charter and cut always-loaded context: run keystone allocate, review its classifications, then apply. Triggers: keystone allocate; keystone:allocate; /keystone:allocate; convert my .claude setup; migrate .cursorrules; trim CLAUDE.md; reduce context bloat.
Keystone Audit
44tacoda/keystone
Full dual-flywheel audit — Learning (capture from review) + Pruning (remove dead rules). Periodic charter hygiene. Triggers: keystone audit; keystone:audit; /keystone:audit; run audit; audit the charter; dual flywheel audit.
Keystone Bootstrap
44tacoda/keystone
One-time initial charter scaffold — detect stack, seed state, scaffold idioms, classify hooks, build the globs index. Triggers: keystone bootstrap; keystone:bootstrap; /keystone:bootstrap; run bootstrap; bootstrap the charter; bootstrap the keystone charter; first-time setup.
My Brain Is Full Crew
57javimosch/supercli
Use this skill when the user wants to use My-Brain-Is-Full-Crew for Built by a PhD whose memory was failing, whose diet was a mess, and whose anxiet.
Keystone Orient
44tacoda/keystone
Enter the planning phase — load codebase state + matching idioms for the touched region, then sketch a plan. Triggers: keystone orient; keystone:orient; /keystone:orient; enter planning phase; orient on this task; load idioms for the touched region.
OpenOats
57javimosch/supercli
Use this skill when the user wants to use OpenOats for A meeting note-taker that talks back..
Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.