Skills
.Work. You
Rest

grug-review

Community

Trim code complexity with grug-brain reviews.

Software Engineering#refactoring#readability#maintainability#complexity#code-review#premature-abstraction#grug-brain
AuthorNavarrePratt
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Grug-review tackles the natural tendency to overlook unnecessary complexity in code changes by providing a principled, anti-complexity lens for PR reviews.

Core Features & Use Cases

  • Complexity check: flags added layers of abstraction or unnecessary logic.
  • Abstraction smell: identifies premature abstractions before necessity emerges.
  • Locality and cut points: evaluates if changes keep related code together and choose natural refactor points.
  • Readability over cleverness: prioritizes maintainable, explicit code over clever tricks.
  • Guardrails for refactoring: supports safe, incremental improvements during reviews.

Quick Start

Review the latest PR using the grug-brain checklist to identify unnecessary complexity.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: grug-review
Download link: https://github.com/NavarrePratt/claude-settings/archive/main.zip#grug-review

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.