code-review

Review game code files for architecture, SOLID, and standards compliance.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/emcconnell/nova-scout --skill code-review-emcconnell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-review
Source: https://github.com/emcconnell/nova-scout/tree/main/.claude/skills/code-review
Command: npx skills add https://github.com/emcconnell/nova-scout --skill code-review-emcconnell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a repeatable, thorough review process that identifies architectural violations, standards drift, maintainability regressions, and testability or performance issues across a codebase so teams can ship safer, more maintainable game systems.

Core Features & Use Cases

  • File-level and system-level reviews: Loads target files, inspects scene and module boundaries, and evaluates cross-module dependencies.
  • ADR and standards compliance: Searches for ADR references, extracts decisions, and classifies deviations as violations, drift, or minor deviations.
  • Architecture, SOLID, and game-specific checks: Evaluates dependency direction, circular dependencies, SOLID principles, delta-time usage, hot-path allocations, and resource cleanup.
  • Specialist orchestration: Spawns language, shader, UI, and QA specialist reviews in parallel when configured, and aggregates their findings into a structured verdict.
  • Use Case: Run during pull requests or story handoffs to catch architectural regressions, ensure acceptance criteria are testable, and produce actionable "Required Changes" and "Suggestions".

Quick Start

Run the code-review skill against the path to your file or directory to receive a structured architectural and standards review with prioritized fixes.

Frequently Asked Questions about code-review

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

FAQPage Schema
How do I perform an architectural code review for a game development codebase?

An architectural code review evaluates scene and module boundaries, cross-module dependencies, SOLID principles, and delta-time usage. It loads target files to identify structural violations, standards drift, and maintainability regressions across engine, gameplay, UI, and shader files.

How do I verify ADR compliance during a pull request?

ADR compliance verification searches for Architecture Decision Records, extracts decisions, and classifies any deviations as violations, drift, or minor deviations. This ensures code changes align with established architectural standards before merging.

Can I run automated code reviews on Godot engine and gameplay files?

Yes, automated code reviews apply to game development codebases including Godot engine, gameplay, UI, and shader files. The review checks dependency direction, circular dependencies, hot-path allocations, and resource cleanup specific to game systems.

What's the best way to check SOLID principles and testability in game code?

Checking SOLID principles and testability involves evaluating dependency direction, circular dependencies, and whether acceptance criteria are testable. The review produces actionable Required Changes and Suggestions to improve maintainability and performance.

How does specialist orchestration work during a code review?

Specialist orchestration spawns language, shader, UI, and QA specialist reviews in parallel when configured. It aggregates their findings into a structured verdict, providing comprehensive coverage across different technical domains.

When should I run a code review during the development workflow?

Run code reviews during pull requests, story reviews, and QA handoffs. This timing catches architectural regressions early, ensures acceptance criteria remain testable, and produces prioritized fixes before code reaches production.