Agent skill
brooks-debt
Tech debt assessment drawing on twelve classic engineering books: The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design, A Philosophy of Software Design, Software Engineering at Google, xUnit Test Patterns, The Art of Unit Testing, Working Effectively with Legacy Code, and How Google Tests Software. Triggers when: user asks about tech debt, where to refactor, health check, or systemic maintainability questions. Also triggers when user asks why the codebase is hard to maintain, why adding developers isn't helping, or why complexity keeps growing. Use this skill proactively when maintainability or refactoring priorities are discussed.
Install this agent skill to your Project
npx add-skill https://github.com/hyhmrright/brooks-lint/tree/main/skills/brooks-debt
SKILL.md
Brooks-Lint — Tech Debt Assessment
Setup
- Read
../_shared/common.mdfor the Iron Law, Project Config, Report Template, and Health Score rules - Read
../_shared/source-coverage.mdfor book-level coverage, exceptions, and tradeoffs - Read
../_shared/decay-risks.mdfor symptom definitions and source attributions - Read
debt-guide.mdin this directory for the debt classification framework
Process
- Scan for all six decay risks; list every finding before scoring any of them
- Apply the Pain x Spread priority formula
- Output using the Report Template from common.md, plus the Debt Summary Table
Mode line in report: Tech Debt Assessment
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
brooks-audit
Architecture audit drawing on twelve classic engineering books: The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design, A Philosophy of Software Design, Software Engineering at Google, xUnit Test Patterns, The Art of Unit Testing, Working Effectively with Legacy Code, and How Google Tests Software. Triggers when: user asks to audit architecture, review module structure, check system design, or assess project organization. Also triggers when user mentions: clean architecture / dependency inversion / hexagonal architecture / bounded contexts / module coupling / package structure. Use this skill proactively when project structure or module dependencies are discussed.
brooks-test
Test quality review drawing on twelve classic engineering books, with primary focus on xUnit Test Patterns, The Art of Unit Testing, How Google Tests Software, and Working Effectively with Legacy Code. Triggers when: user asks about test quality, flaky tests, mock abuse, test debt, legacy code testability, or shares test files for review. Also triggers when user mentions: test smells / characterization tests / test pyramid / test doubles / over-mocking / brittle tests. Use this skill proactively whenever test files are shared for review.
brooks-review
PR code review drawing on twelve classic engineering books: The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design, A Philosophy of Software Design, Software Engineering at Google, xUnit Test Patterns, The Art of Unit Testing, Working Effectively with Legacy Code, and How Google Tests Software. Triggers when: user asks to review code, check a PR, review a pull request, or shares a diff for feedback. Also triggers when user mentions: Brooks's Law / Mythical Man-Month / conceptual integrity / second system effect / code smells / refactoring / clean architecture / DDD / domain-driven design / SOLID principles / Hyrum's Law / deep modules / tactical programming. Use this skill proactively whenever code, a diff, or a PR is shared for review.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
claude-code-expert
Especialista profundo em Claude Code - CLI da Anthropic. Maximiza produtividade com atalhos, hooks, MCPs, configuracoes avancadas, workflows, CLAUDE.md, memoria, sub-agentes, permissoes e integracao com ecossistemas.
lex
Centralized 'Truth Engine' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.
Didn't find tool you were looking for?