Keystone Debt Review

Triage the code-debt ledger — review the code-debt findings and update .agents/references/state/code-debt.md. Triggers: keystone debt-review; keystone:debt-review; /keystone:debt-review; review code debt; triage debt ledger; debt review.

44 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add tacoda/keystone --skill keystone-debt-review
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-debt-review ~/.claude/skills/keystone-debt-review

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:debt-review — triage the code-debt ledger

Reads the code-debt subagent's latest findings and reconciles them against
`.agents/references/state/code-debt.md`. Each finding gets one of:
keep (still real), close (resolved), defer (not now), or escalate
(promote to charter-debt or a rule).

Subagent
contract at `.agents/agents/code-debt.md`.

## Run

**Triage the code-debt ledger.** Read [`.agents/agents/code-debt.md`](../../agents/code-debt.md) and [`.agents/references/state/code-debt.md`](../../references/state/code-debt.md).

For **charter debt** (stale rules, placeholder bootstrap, empty idiom dirs, uncited policies), use the [`audit`](../keystone-audit/SKILL.md) command. Its Pruning flywheel writes to `.agents/references/state/charter-debt.md`.

## Activities

1. **Run the code-debt subagent.** Walk the codebase for markers and complexity hotspots; produce the candidate list.
2. **Triage `discovery` items.** For each, propose: a category (deliberate / drift / shortcut), a severity, an owner, and a revisit trigger. If you can't propose all four, leave the item as `discovery` with a note explaining why.
3. **Re-score existing items.** Compare ledger entries against the code. Items whose region is no longer present, or whose severity has dropped to nothing the diff or plan would notice, become `stale`.
4. **Prune `stale` items.** Delete them from the ledger. Do not archive.
Read the full skill on GitHub

Details

Skill name
keystone-debt-review
Path
.agents/skills/keystone-debt-review/SKILL.md
License
MIT
Repo updated
17 November 2026

FAQ

What does the Keystone Debt Review skill do?

Triage the code-debt ledger — review the code-debt findings and update .agents/references/state/code-debt.md. Triggers: keystone debt-review; keystone:debt-review; /keystone:debt-review; review code debt; triage debt ledger; debt review.

How do I install the Keystone Debt Review skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add tacoda/keystone --skill keystone-debt-review. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Keystone Debt Review popular?

It lives in tacoda/keystone, which has 44 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.