review

review is a skill for Claude Code, Codex from bcanfield/agentic-tech-debt. It costs 70 tokens per session (985 once invoked), scanned A, original, MIT.

A review tool for a tech-debt registry, a list of known codebase shortcuts and maintenance problems. It audits the list, ranks remaining entries, and can guide the user through selected fixes afterward.

In plain words
What is it for?
Use it to review technical debt, see the top items to address, drop stale entries, or work through selected paydown tasks one at a time.
Why use it?
It turns a broad debt list into a short order of priorities based on code churn, meaning how often affected code changes, and the kind of debt involved. It also helps remove entries that are no longer relevant.

Skill for Claude CodeCodex

Installs and runs on its own, but its text points at files inside its plugin — anything it tells you to read at a ${CLAUDE_PLUGIN_ROOT} path is only there once the plugin is installed. Installing the plugin gets both.

Part of the debt-ops plugin — 4 skills, 4 hooks shipped together

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.

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

Made for: Claude Code, Codex.

Or install debt-ops, the plugin that ships this one along with the rest of its 4 skills, 4 hooks.

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 review

README.md
[![agentmods](https://agentmods.dev/badge/skills/bcanfield/agentic-tech-debt/review.svg)](https://agentmods.dev/skills/bcanfield/agentic-tech-debt/review)
Your own site
<a href="https://agentmods.dev/skills/bcanfield/agentic-tech-debt/review"><img src="https://agentmods.dev/badge/skills/bcanfield/agentic-tech-debt/review.svg" alt="Measured on agentmods" height="20"></a>
Per session 70 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 985 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found 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 $0.00070 $0.00985
Opus 5 $0.00035 $0.00492
Sonnet 5 $0.00014 $0.00197
Haiku 4.5 $0.00007 $0.00098

Measured 5d ago against content hash 6787ed3cab86, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

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 5d 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

Copies of this mod

1 near-identical copy found in the catalogue:

claude-code/skills/review/SKILL.md · 60 lines

How it starts

The opening of the file, as written. The whole thing — 60 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

python3 ${CLAUDE_PLUGIN_ROOT}/skills/review/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. Claude Code collapses long bash outputs behind a +N lines, ctrl+o to expand placeholder — if you don't print it yourself, the user never sees 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 cached feedback 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 → invoke /code-review on 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 with drop A, and commits.

Read the full file on GitHub · 60 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. 5d ago First seen · 60 lines · 70 tokens per session scan A 6787ed3cab86

Subscribe to this mod's changes

review is a skill published in the GitHub repository bcanfield/agentic-tech-debt (8 stars, last pushed today), licensed MIT. It adds 70 tokens to every session and 985 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

codex-thread-orchestration

Use when running Arcgentic V2 in Codex and the current thread must orchestrate fixed Planner, Developer, Test, and Auditor role threads.

Arch1eSUN/Arcgentic · 37 tokens

claude-code-session-broker

Use when running Arcgentic V2 in Claude Code and fixed Planner, Developer, and Auditor role sessions must be coordinated through a broker.

Arch1eSUN/Arcgentic · 35 tokens

arcgentic

Use when the user says Arcgentic, asks to use Arcgentic, or wants an idea taken through a complete plan → development → self-audit → external audit workflow in Codex.

Arch1eSUN/Arcgentic · 43 tokens

audit-round

External-audit role for arcgentic rounds. Loaded when arcgentic state.yaml is in awaitingaudit or auditinprogress, OR when the user explicitly requests an external audit of a finished round, OR when reviewing a handoff doc + commit chain against the round's declared scope. Produces a PASS / NEEDSFIX / AUDITINCOMPLETE…

Arch1eSUN/Arcgentic · 117 tokens

orchestrate-round

Main-session orchestrator for arcgentic rounds. Use when in single-session mode, when a project-level session mode must drive dispatch order, or when manually advancing the state machine. Dispatches role sub-agents, verifies structured outputs, and owns PASS-only close-round execution.

Arch1eSUN/Arcgentic · 60 tokens

using-arcgentic

Entry skill for the arcgentic plugin — establishes the four-role workflow (planning / dev+self-audit / external-audit / reference-tracking), the round state machine, and when to switch roles or dispatch sub-agents. Use when starting any session in a project that has .agentic-rounds/state.yaml present, OR when the user…

Arch1eSUN/Arcgentic · 91 tokens