Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

AI Debt Detector · wshobson | DecimalAI

code reviewby wshobson

AI Debt Detector

wshobson/ai-debt-detector

Source wshobson/agents ↗License MIT

Use after generating code, after accepting AI suggestions, or when reviewing AI-written modules. Also use when code works but feels brittle, when error handling seems thin, when orphaned resources or missing cleanup are suspected, or when the agent claims done but hidden debt may exist. Catches the specific failure patterns AI agents produce that humans would not.

SkillScore96Maintained

Automatic

Coding pack

Last verified 8/9/2026

What it changes

Passed 23 of 24 test cases with the skill, and 21 of 24 without it.

Without skill88%

With skill96%

Checks it passed that the model alone missed

Identifies the placeholder TODO comment as an unaddressed failure path.
Recommends reviewing for missing error branches and omitted edge cases.
Points out that inspecting added lines alone misses ungenerated failure paths.

and 1 more in the full report

3 fixed20 passed either way0 still failing1 broke

Pass-rate lift: +8 pp
Tokens: +14%
Agent turns: 0%
Response time: -1%

Model gemini-3.6-flashMeasured 8/9/2026v123 of 24 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/wshobson-ai-debt-detector/SKILL.md https://app.decimal.ai/s/wshobson-ai-debt-detector/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add wshobson-ai-debt-detector, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/wshobson-ai-debt-detector/ and pins it in .decimal/skills.lock

decimalai skills add wshobson-ai-debt-detector

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/wshobson-ai-debt-detector/SKILL.md https://app.decimal.ai/s/wshobson-ai-debt-detector/SKILL.md

Raw file: /s/wshobson-ai-debt-detector/SKILL.md ↗ · machine-readable summary at /s/wshobson-ai-debt-detector.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 3 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 3

Prompt

When reviewing an AI-generated pull request, the reviewer only looked at the added lines in the diff view and verified syntax. What critical review step was missed?

What was checked, without and with the skill
Checked	Without skill	With skill
Points out that inspecting added lines alone misses ungenerated failure paths.	Missed	Passed
Recommends reviewing for missing error branches and omitted edge cases.	Missed	Passed

case-18 · gemini-3.6-flash · 8/9/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md61 linessingle file

AI Debt Detector

Overview

AI agents generate code that passes the happy path but hides debt: missing error handling, orphaned resources, ignored failure modes, hallucinated packages, silent architectural drift. This skill forces a targeted audit for the exact patterns AI agents get wrong.

When to Use

After any AI code generation session (20+ lines produced)
Before merging AI-generated PRs
When code works but something feels off
After vibe-coding sprints where debt accumulates fastest
When the agent claims done without showing verification

Process

After code generation, scan for these AI-specific debt patterns:

FAILURE MODES - What happens when this fails?
- Network timeout? Disk full? Permission denied? Null input?
- Is there a try/catch? Does it catch SPECIFIC errors or swallow everything?
- Are resources cleaned up on failure? (streams closed, connections returned, temp files deleted)
ORPHANS - What gets created but never cleaned up?
- Temp files, event listeners, intervals, subscriptions, connections
- Are there corresponding cleanup/dispose/close calls for every open/create?
- In React: does every addEventListener have a removeEventListener in cleanup?
EDGE CASES - What inputs break this?
- Empty array/string? null/undefined? Multi-MB input? Unicode? Concurrent calls?
- Does the code assume the happy path? (AI almost always does)
HALLUCINATED DEPS - Do all imports actually exist?
- Is every package in package.json/requirements.txt?
- Are API methods real? (AI invents plausible-sounding methods that don't exist)
- Does this library's latest version still export this function?
ARCHITECTURAL DRIFT - Does this match the project's patterns?
- Same error handling style as existing code?
- Uses the project's established utilities (not reinventing)?

Track record

Benchmark

23 / 24

test cases passed, vs 21 / 24 without

Adoption

Users: 1
Times used: 13

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

wshobson / agents

plugins/skill-forge-essentials/skills/ai-debt-detector/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

AI Debt Detector

Overview

When to Use

Process

Track record

Benchmark

Adoption

SkillSafety

Source

Related skills