Agent Skills: grumpy-reviewer
A single grumpy, nitpicky structural code reviewer that runs as an isolated subagent and treats the code as third-party work submitted by a junior programmer for validation. It cares about exactly one thing — maintainability — judged through separation of concerns, service-oriented design, helper-method extraction, small files, and the rule of 7 (as any grouping nears 7 members, it pushes for sub-groupings). It is deliberately kept OUT of the implementation flow: it never learns how the code was produced, only a one-line statement of what it is supposed to do, and its report is plain and factual — the grumpiness is in the scrutiny, not the prose. Use before merging, or any time the user wants a harsh structural / maintainability / "is this well-factored" opinion: when a file, class, function, or parameter list feels too big or over-stuffed; when responsibilities look tangled or a layer (controller, handler, component) is doing too much; when the user asks whether to split or break up a unit, whether helpers should be extracted, where the code "will rot", or whether it is maintainable; or for a grumpy / pedantic / nitpicky / curmudgeon second opinion that ignores how the code came to be. Triggers on "/grumpy-reviewer", "grumpy review", "nitpicky review", "structural review", "is this well factored", "too many responsibilities", "where will this rot", "should I split this up", "this file/class/method feels too big", "check separation of concerns", "review my structure", "rule of 7". Do NOT use it for correctness or behavior reviews — "does it work", "will it crash", "find bugs", "review under load", "is it reliable" — that is /adversarial-reviewer; nor for security reviews — injection, auth, secrets, OWASP — that is /security-review; nor for the per-phase architectural-compliance / ADR gate inside implement-phase — that is /code-review. This skill is one opinionated maintainability reviewer, nothing else.
Install this agent skill to your local
Skill Files
The files that make up grumpy-reviewer.
Loading file tree…
More agent skills
- prompt-generatorGenerate implementation prompts for phase-based project execution using an orchestration pattern. Use when users request prompts for implementing project phases, need orchestration prompts for multi-step implementations, ask for "/prompt", "generate prompt", "create implementation prompt", or want to create structured implementation instructions for subagent delegation. Outputs the prompt to chat and saves to docs/prompts folder.
- codebase-researchOrchestrates comprehensive codebase research by decomposing user queries into parallel sub-agent tasks and synthesizing findings. This skill should be used when users ask questions about how code works, where functionality exists, how components interact, or need comprehensive documentation of existing implementations. It focuses exclusively on documenting and explaining the codebase as it exists today.
- create-planCreate detailed implementation plans through interactive research and iteration. This skill should be used when creating new implementation plans, designing feature specifications, planning technical work, or when the user asks to plan an implementation. Triggers on requests like "create a plan", "plan the implementation", "design how to implement", or when given a feature/task that needs structured planning before implementation.
- benchling-integrationBenchling Python SDK and REST API integration for registry entities, inventory, ELN entries, workflows, Benchling Apps, and Data Warehouse queries. Use when automating lab data with benchling-sdk or the v2 API.
- write-exampleWriting examples for the tldraw SDK examples app. Use when creating new examples, adding SDK demonstrations, or writing example code in apps/examples.
- dart-retroDART Retro: run a retrospective and capture durable lessons