Skip to content

Add curated brooks-lint skill#328

Open
hyhmrright wants to merge 1 commit intoopenai:mainfrom
hyhmrright:add-brooks-lint-skill
Open

Add curated brooks-lint skill#328
hyhmrright wants to merge 1 commit intoopenai:mainfrom
hyhmrright:add-brooks-lint-skill

Conversation

@hyhmrright
Copy link
Copy Markdown

Summary

  • Add brooks-lint as a curated skill: AI code reviews grounded in six classic engineering books (The Mythical Man-Month, Code Complete, Refactoring, Clean Architecture, The Pragmatic Programmer, Domain-Driven Design)
  • Four analysis modes: PR review, architecture audit, tech debt assessment, test quality review
  • Every finding follows the Iron Law: Symptom, Source, Consequence, Remedy
  • Health score system (base 100, deductions per finding severity)

Skill structure

skills/.curated/brooks-lint/
  SKILL.md                           # Main skill definition with mode detection
  LICENSE.txt                        # MIT
  agents/openai.yaml                 # Codex interface metadata
  references/decay-risks.md          # Six decay risk definitions with symptoms + sources
  references/pr-review-guide.md      # Mode 1: PR review checklist
  references/architecture-guide.md   # Mode 2: Architecture audit (with Mermaid diagrams)
  references/debt-guide.md           # Mode 3: Tech debt classification
  references/test-decay-risks.md     # Six test-space decay risks
  references/test-guide.md           # Mode 4: Test quality review

Validation

python3 skills/.system/skill-creator/scripts/quick_validate.py skills/.curated/brooks-lint
# => Skill is valid!

Source

Full skill with Claude Code plugin support: https://github.com/hyhmrright/brooks-lint

Code quality reviews grounded in six classic engineering books with four
analysis modes: PR review, architecture audit, tech debt assessment, and
test quality review.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@hyhmrright hyhmrright requested a review from a team April 1, 2026 12:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant