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.

44 stars 3 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add tacoda/keystone --skill keystone-spec
Manual install
git 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-spec

Personal 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
Read the full skill on GitHub

Details

Skill name
keystone-spec
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

44

tacoda/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.

AI, LLMs & Agents

Keystone Audit

44

tacoda/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.

Data & Analytics

Keystone Bootstrap

44

tacoda/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.

Data & Analytics

My Brain Is Full Crew

57

javimosch/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.

Productivity & NotesIn 1 list

Keystone Orient

44

tacoda/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.

Productivity & Notes

OpenOats

57

javimosch/supercli

Use this skill when the user wants to use OpenOats for A meeting note-taker that talks back..

Productivity & NotesIn 1 list

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.