brooks-review
PR code review that surfaces decay risks, design smells, and maintainability issues with concrete Symptom → Source → Consequence → Remedy findings, drawing on…
Skill by Aaryan1524
Chalk Labs
Need help deploying brooks-review?
Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/aaryan1524-brooks-review
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: design, writing, legal
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions: not checked yet.
What's inside
- Skill name
brooks-review- Description
- PR code review that surfaces decay risks, design smells, and maintainability issues with concrete Symptom → Source → Consequence → Remedy findings, drawing on twelve classic engineering books. Triggers when: user asks to review code, check a PR, shares a diff or pastes code asking "does this look right?" / "any issues here?" / "ready to merge?", or asks for feedback on a function, class, or file. Also triggers when user mentions: code smells / refactoring / clean architecture / DDD / SOLID principles / Hyrum's Law / deep modules / tactical programming / conceptual integrity / Brooks's Law / Mythical Man-Month / second system effect. Do NOT trigger for: questions about how to write code from scratch, language syntax questions, or framework/tool questions where no existing code is shared.
- License
- MIT
- Instructions
- 24 lines in SKILL.md · view on GitHub
Files (2)
- SKILL.md
- pr-review-guide.md
SKILL.md (first lines)
# Brooks-Lint — PR Review ## Setup Read in order: 1. `../_brooks-shared/common.md` — Iron Law, Project Config, Report Template, Health Score 2. `../_brooks-shared/source-coverage.md` — book coverage, exceptions, tradeoffs 3. `../_brooks-shared/decay-risks.md` — symptom definitions and source attributions 4. `pr-review-guide.md` (this directory) — the analysis process ## Process **Scope:** if the user did not specify files or paste code, apply Auto Scope Detection (`../_brooks-shared/common.md`) first. 1. Understand the review scope, then scan for each decay risk in the order specified (Steps 1–6 of the guide) 2. Run the Quick Test Check (Step 7 of the guide) — skip for docs-only or non-production changes 3. Apply the Iron Law to every finding 4. Output using the Report Template from common.md **Mode line in report:** `PR Review`
From Aaryan1524/Codex_Skills, MIT.
More from Aaryan1524/Codex_Skills
- 0.552score
ci-repair
Aaryan1524
Inspect GitHub PR checks with gh, pull failing GitHub Actions logs, summarize failure context, then create a fix plan and implement after user approval.
SkillBFreshness: B★ 1Claude Code +9 - 0.552score
editor-deep-links
Aaryan1524
Build, validate, and troubleshoot deep links for Codex, Cursor, VS Code, Visual Studio, and similar tools.
SkillBFreshness: B★ 1Claude Code +9 - 0.549score
business-artifacts
Aaryan1524
Generate PPTX presentations, DOCX documents, XLSX spreadsheets, and PDF reports from structured JSON input using PaperJSX.
SkillBFreshness: B★ 1Claude Code +9 - 0.547score
developer-growth
Aaryan1524
Analyze user-authorized coding history or project material to identify development patterns and learning opportunities.
SkillBFreshness: B★ 1Claude Code +9 - 0.547score
langsmith-analysis
Aaryan1524
Debug LangChain and LangGraph agents by fetching execution traces from LangSmith Studio.
SkillBFreshness: B★ 1Claude Code +9 - 0.544score
image-polish
Aaryan1524
Improves the quality of images, especially screenshots, by enhancing resolution, sharpness, and clarity.
SkillBFreshness: B★ 1Claude Code +9 - 0.544score
codex-migration-audit
Aaryan1524
Audit Claude Code to Codex harness migrations, including AGENTS.md/CLAUDE.md scope, hooks, MCP config, skills, secrets, and validation notes.
SkillBFreshness: B★ 1Claude Code +9 - 0.544score
lead-intel
Aaryan1524
Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact…
SkillBFreshness: B★ 1Claude Code +9 - 0.544score
app-integrations
Aaryan1524
Connect Codex to any app via the Composio CLI.
SkillBFreshness: B★ 1Claude Code +9 - 0.522score
find-skills
Aaryan1524
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express…
SkillBFreshness: B★ 1Claude Code +9 - 0.519score
design-tokens
Aaryan1524
Toolkit for styling artifacts with a theme.
SkillBFreshness: B★ 1Claude Code +9 - 0.291score
engineering-review
Aaryan1524
No description from the publisher yet.
SkillBFreshness: B★ 1Claude Code +9
Signals
- Stars
- 1
- Forks
- 0
- Open issues
- 0
- Last commit (this folder)
- Sep 12, 2026 (1 month ago)
From GitHub (fetched Oct 24, 2026).
Details
- License
- MIT
- Repository
- github.com/Aaryan1524/Codex_Skills
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
Same skill elsewhere
Copies of this SKILL.md published by others; search shows only one of them.
- 0.826score
brooks-review
hyhmrright
PR code review that surfaces decay risks, design smells, and maintainability issues with concrete Symptom → Source → Consequence → Remedy findings, drawing on…
SkillAFreshness: A★ 1.5KClaude Code +9 - 0.312score
brooks-review
hanzxtf
PR code review that surfaces decay risks, design smells, and maintainability issues with concrete Symptom → Source → Consequence → Remedy findings, drawing on…
SkillBFreshness: BClaude Code +9 - 0.295score
brooks-review
HONGKONGBALL
PR code review that surfaces decay risks, design smells, and maintainability issues with concrete Symptom → Source → Consequence → Remedy findings, drawing on…
SkillCFreshness: C★ 1Claude Code +9
More from Aaryan1524
- 0.552score
ci-repair
Aaryan1524
Inspect GitHub PR checks with gh, pull failing GitHub Actions logs, summarize failure context, then create a fix plan and implement after user approval.
SkillBFreshness: B★ 1Claude Code +9 - 0.552score
editor-deep-links
Aaryan1524
Build, validate, and troubleshoot deep links for Codex, Cursor, VS Code, Visual Studio, and similar tools.
SkillBFreshness: B★ 1Claude Code +9 - 0.549score
business-artifacts
Aaryan1524
Generate PPTX presentations, DOCX documents, XLSX spreadsheets, and PDF reports from structured JSON input using PaperJSX.
SkillBFreshness: B★ 1Claude Code +9 - 0.547score
developer-growth
Aaryan1524
Analyze user-authorized coding history or project material to identify development patterns and learning opportunities.
SkillBFreshness: B★ 1Claude Code +9 - 0.547score
langsmith-analysis
Aaryan1524
Debug LangChain and LangGraph agents by fetching execution traces from LangSmith Studio.
SkillBFreshness: B★ 1Claude Code +9 - 0.544score
image-polish
Aaryan1524
Improves the quality of images, especially screenshots, by enhancing resolution, sharpness, and clarity.
SkillBFreshness: B★ 1Claude Code +9
Done for you
Rather not set it up yourself?
Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.
See how we build AI agents →Read the case studies
Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.
- launches shipped
- 50+
- launches shipped
- media placements
- 500+
- media placements
- founders on every account
- 2
- founders on every account
Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block
Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.
Get brooks-review running in your business
Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.
Cite this page
brooks-review skill. Agent Mart. https://agentmart.dev/skills/aaryan1524-brooks-review (last updated 2026-10-24)