oo-review

Identify object-oriented patterns in code changes and evaluate their implementation.

1|Updated Jul 31, 2023
One-click install
npx skills add https://github.com/austintheriot/dotfiles --skill oo-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oo-review
Source: https://github.com/austintheriot/dotfiles/tree/main/.claude/skills/oo-review
Command: npx skills add https://github.com/austintheriot/dotfiles --skill oo-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you review object-oriented code when you may not recognize the patterns being used, so you can understand what’s going on, judge whether it’s applied well, and consider better alternatives.

Core Features & Use Cases

  • Pedagogical OO pattern identification: Names the likely OO lineage and patterns in play (Gang of Four, DDD, hexagonal/clean/onion, and modern hybrids) and explains them briefly when unfamiliar.
  • Severity-labeled findings with locations: Produces actionable findings tagged by severity (blocker/major/minor/nit) plus separate pedagogical-note entries, including file:line references.
  • Targeted scope and routing: Reviews changes by default against the main branch, supports review via file paths or PR/range, and routes deep questions to specialized subagents for patterns, architecture, or domain modeling.

Quick Start

Use oo-review on a specific PR by saying: review PR 123 with OO pattern and architecture critique.

Frequently Asked Questions about oo-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review object-oriented code and identify design patterns in a PR diff?

To review object-oriented code in a PR diff, the skill identifies applied patterns like Gang of Four or DDD, evaluates their implementation quality, and provides severity-labeled findings with file:line references. It also explains unfamiliar patterns pedagogically.

What's the best way to check if my code correctly applies DDD and clean architecture patterns?

Checking DDD and clean architecture application involves routing deep domain modeling questions to specialized subagents that recognize pattern lineages against authoritative rules, differentiating between blockers, design issues, and educational notes.

Can I review code changes using file paths or git ranges instead of a PR?

Yes, you can review code changes using file paths or git ranges. The skill supports path-based surveys and excludes generated, lockfile, or irrelevant content automatically, allowing targeted deep dives into specific areas of your codebase.

How does object-oriented pattern recognition work when reviewing unfamiliar code?

Object-oriented pattern recognition works by naming the likely OO lineage in play, such as hexagonal or onion architectures, and briefly explaining the concepts when they are unfamiliar, helping you understand the code and consider better alternatives.

What severity levels are used when reviewing OO code for architecture and design issues?

When reviewing OO code, findings are tagged by severity as blocker, major, minor, or nit. Separate pedagogical-note entries are also produced alongside these actionable findings to provide educational context for the identified design issues.

How do I get architecture critique and pedagogical guidance for object-oriented design changes?

To get architecture critique and OO design guidance, review your changes against the main branch and request deep dives. The skill routes complex architecture and pattern questions to specialist subagents for targeted, expert evaluation.