Ready to supercharge your AI agents?

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

Brooks-Lint — Tech Debt Assessment — measured AI agent skill | DecimalAI

hyhmrright/brooks-debt

SkillScore45Maintained

Tech debt assessment that identifies, classifies, and prioritizes maintainability problems — helping teams build a refactoring roadmap — drawing on twelve classic engineering books. Triggers when: user asks about tech debt, refactoring priorities, what to clean up first, or asks "why is this so hard to change?", "what should we fix first?", or "how do I justify refactoring to management?". Do NOT trigger for: server health checks, HTTP /health endpoints, Kubernetes probes, database health, or ap

Code Reviewby hyhmrright

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Coding pack

decimalai skills pull hyhmrright-brooks-debt

Get this skill — curl · raw file

curl -fsSL https://app.decimal.ai/s/hyhmrright-brooks-debt/SKILL.md

Raw file: /s/hyhmrright-brooks-debt/SKILL.md ↗ · machine-readable summary at /s/hyhmrright-brooks-debt.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 4h ago

Yes — +23% lift · at higher cost+40% tokens0% turns45% of whole cases pass with skill (10/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-01	✗→✓	▲ Improved	2%	0%
case-08	✗→✓	▲ Improved	97%	0%
case-11	✗→✓	▲ Improved	496%	0%
case-12	✗→✓	▲ Improved	285%	0%
case-15	✗→✓	▲ Improved	237%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

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

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

hyhmrright / brooks-lint

skills/brooks-debt/SKILL.md

View on GitHub ↗

License MITImported 8/10/2026Version v2

Skill contents

SKILL.md

Brooks-Lint — Tech Debt Assessment

Setup

Read in order:

../_shared/common.md — Iron Law, Project Config, Report Template, Health Score
../_shared/source-coverage.md — book coverage, exceptions, tradeoffs
../_shared/decay-risks.md — symptom definitions and source attributions
debt-guide.md (this directory) — the debt classification framework

Process

Scope: if the user did not describe the codebase or point to specific areas, apply Auto Scope Detection (../_shared/common.md) first.

Scan for all six decay risks (Step 1 of the guide); list every finding before scoring
Apply the Pain × Spread priority formula and classify debt intent (Steps 2–3 of the guide)
Group findings by decay risk (Step 4 of the guide)
Output using the Report Template from common.md, plus the Debt Summary Table

Mode line in report: Tech Debt Assessment

Want to see if hyhmrright/brooks-debt would activate on your phrasing? Try it before you install — no LLM call, no signup.

Other measured skills in the registry, with their headline benchmark lift.