debt-ops-review

debt-ops-review is a skill for Claude Code, Codex from bcanfield/agentic-tech-debt. It costs 72 tokens per session (964 once invoked), scanned A, a copy of review, MIT.

A review tool for a tech-debt registry, which is a list of known shortcuts, unfinished work, and maintenance problems in a codebase. It ranks the remaining entries using how often affected code changes and a classification of how the debt arose.

In plain words
What is it for?
Use it to audit the debt registry, produce a prioritized shortlist, identify stale entries, and work through chosen paydown tasks one at a time.
Why use it?
It helps teams decide which maintenance problems deserve attention first instead of relying on an unranked list. It can then guide work on selected entries after the user chooses them.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to audit the debt registry, produce a prioritized shortlist, identify stale entries, and work through chosen paydown tasks one at a time.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/bcanfield/agentic-tech-debt/debt-ops-review
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add bcanfield/agentic-tech-debt --skill debt-ops-review
Clone the repo
git clone --depth 1 https://github.com/bcanfield/agentic-tech-debt

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for debt-ops-review

README.md
[![agentmods](https://agentmods.dev/badge/skills/bcanfield/agentic-tech-debt/debt-ops-review/github.svg)](https://agentmods.dev/skills/bcanfield/agentic-tech-debt/debt-ops-review)
Your own site
<a href="https://agentmods.dev/skills/bcanfield/agentic-tech-debt/debt-ops-review"><img src="https://agentmods.dev/badge/skills/bcanfield/agentic-tech-debt/debt-ops-review/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for debt-ops-review

Your own site · 80×15
<a href="https://agentmods.dev/skills/bcanfield/agentic-tech-debt/debt-ops-review"><img src="https://agentmods.dev/badge/skills/bcanfield/agentic-tech-debt/debt-ops-review.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 72 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 964 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 86% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00072 $0.00964
Opus 5 $0.00036 $0.00482
Sonnet 5 $0.00014 $0.00193
Haiku 4.5 $0.00007 $0.00096

Measured 9d ago against content hash 9ac24ae23f50, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

debt-ops-review scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/review.py), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

86% identical to review — 72 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

copilot/skills/debt-ops-review/SKILL.md · 84 lines

How it starts

The opening of the file, as written. The whole thing — 84 lines — stays where its author put it; the contents beside it link to each section on GitHub.

debt-ops-review — audit + (on follow-up) walk paydown

Two modes. First turn: print the audit and stop. On a user follow-up ("fix the top one," "walk these," "do A," "pay some down"), apply the rubric below.

First turn: print the audit

Run the bundled review.py (it lives in this skill's scripts/ directory — reference it with the relative path; your agent resolves it against the skill root):

python3 scripts/review.py

Optional: --top N to surface more than the default 3 candidates.

Re-emit the helper's stdout verbatim in a fenced code block. Some agents collapse long shell outputs — if you don't print it yourself, the user might not see it. Copy exactly: no preamble, no summary, no "want me to fix the top one?" The fenced block preserves column alignment.

Then stop. The user picks the next move.

Paydown mode (only on user follow-up)

Work through requested entries one at a time. Confirm before each fix. Never auto-batch. Never auto-commit.

For each entry, read the registry file, the hotspot, and adjacent tests. Apply this rubric:

  • Already fixed? If the marker/symptom the entry describes no longer appears in the hotspot file, say so and add the entry's letter to the drop list. Don't re-fix.
  • Cold area? Churn=0 since created: and age >90d → propose deferring. ~20% of files generate ~80% of debt-related rework; don't pay down vanity refactors.
  • Prudent-deliberate with payoff_trigger not met? Honor the trigger. Skip with a one-line "trigger not met: ."
  • Fix candidate? Propose the smallest change that resolves the entry. Improvement, not perfection — don't refactor surrounding code.

When you fix

  • Read the repo first. Check the test framework, adjacent tests, the project's quality commands. Adapt to what exists; don't impose a new style.
  • TDD where tests exist. Write a failing test that pins the deferral, then make it pass. Don't weaken or delete existing tests to make a fix pass.
  • No tests in this area? Surface that and ask: write one, or fix without?
  • Explain why this resolves the entry. Cite the entry's payoff_trigger or body — don't commit code you can't explain.
  • Risky fix? Auth, payments, migrations, public APIs, or ai_authored: true → run a fresh-context review of the diff before suggesting commit. Fresh-context review catches what the writer's motivated reasoning misses.
  • Don't commit. Show the diff. The user runs the gates, drops the entry, and commits.

Read the full file on GitHub · 84 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 84 lines · 72 tokens per session scan A 9ac24ae23f50

Subscribe to this mod's changes

debt-ops-review is a skill published in the GitHub repository bcanfield/agentic-tech-debt (8 stars, last pushed today), licensed MIT. It adds 72 tokens to every session and 964 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. It is 86% identical to review, differing in 72 lines, and is treated as a copy.

Related

Other skills, from other repositories

execute-round

Use when a planned round handoff exists and needs to be implemented end-to-end via the 4-commit chain (entry-admin → BA design → dev body with inline CR + SE → state refresh + self-audit). Dispatches ba-designer / developer / cr-reviewer / se-contract sequentially.

Arch1eSUN/Arcgentic · 65 tokens

retro

Engineering retrospective from git metrics. Reports deployment frequency, release cycle span, churn hotspots, backlog health. Outputs narrative report with 3+ actionable items. Flags: --since, --path, explicit range argument.

greglas75/zuvo · 44 tokens

backlog

Manage the project's tech debt backlog. Add, list, fix, wontfix, delete, prioritize, and suggest batch actions on tracked issues. Used by audit and review skills to persist findings, and directly by users to manage accumulated debt. Modes: list [category], add [description], fix B-{N}, wontfix B-{N} [reason], delete…

greglas75/zuvo · 85 tokens

ccc-broadcast

Relay CC Commander build, deploy, CI, task, and cost signals to your team's chat or email so non-devs see what shipped — read-only, no secrets in payloads.

KevinZai/commander · 41 tokens

ccc-linear

Linear board integration — view open issues, pick one to work on, or create new tickets without leaving Claude. Use when the user types $ccc-linear, /ccc linear, says…

KevinZai/commander · 40 tokens

ccc-onboard

CC Commander contributor onboarding workflow. Detects project conventions, asks for contributor role, builds a tailored first-hour checklist, starter links, and…

KevinZai/commander · 32 tokens