Skills for Real Engineers. Straight from my .agents directory.
39 skills
brooks-debt
Agent skill from
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 application uptime — "health" in those contexts is infrastructure, not code quality. Also not for single-function refactoring questions.
How to install brooks-debt
install brooks-debt
# install the brooks-lint pack with the skills CLI
npx skills add hyhmrright/brooks-lint# or add only this skill to Claude Code: copy the folder
skills/brooks-debt/
# into
~/.claude/skills/brooks-debt/ (all projects)
.claude/skills/brooks-debt/ (one project)
1# Brooks-Lint — Tech Debt Assessment23## Setup45Read in order:671. `../_shared/common.md` — Iron Law, Project Config, Report Template, Health Score82. `../_shared/source-coverage.md` — book coverage, exceptions, tradeoffs93. `../_shared/decay-risks.md` — symptom definitions and source attributions104. `debt-guide.md` (this directory) — the debt classification framework1112## Process1314**Scope:** if the user did not describe the codebase or point to specific areas, apply15Auto Scope Detection (`../_shared/common.md`) first.16171. Scan for all six decay risks (Step 1 of the guide); list every finding before scoring182. Apply the Pain × Spread priority formula and classify debt intent (Steps 2–3 of the guide)193. Group findings by decay risk (Step 4 of the guide)204. Output using the Report Template from common.md, plus the Debt Summary Table2122**Mode line in report:** `Tech Debt Assessment`
Excerpt shown under the repository's MIT license.
More skills in brooks-lint
Keep exploring
Similar skill repositories
An agentic skills framework & software development methodology that works.
15 skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
CC1 skill
Public repository for Agent Skills
20 skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
CCCU6 skills
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
CCCXGHGM+135 skills