← All skills

brooks-debt

95 / 100 · Low risk

Fine to try. Some of what it can do is expected: a coding skill usually runs build and test commands.

By hyhmrright/brooks-lint (GitHub) · coding · 1,571 stars · scanned at commit 019c9cf

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 a…

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'brooks-debt' ] || [ -L ~/.agents/skills/'brooks-debt' ]; then echo 'A skill folder named brooks-debt already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/hyhmrright/brooks-lint' "$d" && git -C "$d" checkout --quiet '019c9cf7ff3bbdc9de8e13c300deebb50d70ec3c' -- 'skills/brooks-debt' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/brooks-debt' ~/.agents/skills/'brooks-debt' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'brooks-debt' ~/.claude/skills/'brooks-debt' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for hyhmrright/brooks-lint shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/hyhmrright/brooks-lint.svg)](https://zalavijaysinh.github.io/skilltrust/repos/hyhmrright/brooks-lint/)

Score history