skills.rest
imclab
imclabOFFICIAL
Explore all skills by this author →
Website𝕏@TheIMCLabGitHub

code-review

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

1|Updated May 3, 2026
Search Tags:#architecture#code review#testability#quality gates#solid principles#adr compliance#game engineering
One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill code-review-imclab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-review
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/code-review
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill code-review-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you prevent brittle, inconsistent, and hard-to-test code by performing a structured review focused on architecture, standards, ADR compliance, SOLID principles, and performance-minded game-specific concerns.

Core Features & Use Cases

  • Targeted file-based review: Reviews a specified file or directory by reading project standards from CLAUDE.md and inspecting the target codebase.
  • Engine specialist triage: Detects the right review lens based on file type (primary language, shader, UI) and runs the applicable specialists in parallel.
  • ADR compliance verification: Searches for ADR references (e.g., ADR-NNN or architecture ADR paths) and flags architectural drift, drift severity, or violations against extracted Decision/Consequences.
  • Quality gates: Checks documentation, complexity/size limits, dependency direction, layer separation, events/signals usage, and SOLID compliance.
  • Testability review: For logic/integration scenarios, evaluates whether provided QA test cases map to real, testable code paths and identifies untestable acceptance criteria and missing seams.
  • Output structured verdict: Produces a consistent review report including findings, required changes, suggestions, and an approval status.

Quick Start

Use the code-review skill to review the system files in the directory 'src/' and return a structured verdict with required changes.

Frequently Asked Questions about code-review

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

FAQPage Schema
How do I automate architectural code review to enforce SOLID principles and ADR compliance?▼

To perform an architectural code review, the system reads project standards from CLAUDE.md and inspects the specified target codebase. It detects the file type to apply the correct specialist lens, checking SOLID principles, layer separation, and ADR references, then returns a structured verdict.

What is the best way to check code testability against QA test cases?▼

Code testability is verified by mapping provided QA test cases against real code paths in logic and integration scenarios. This identifies untestable acceptance criteria and missing seams, ensuring the implementation meets quality gates and stated test requirements.

How do I enforce dependency direction and layer separation in an evolving codebase?▼

Dependency direction and layer separation are enforced through quality gates that inspect the target codebase against project standards. The review flags architectural drift and violations, reporting structured findings with required changes to prevent unreadable design.

Can I use automated code review for game engine and shader implementations?▼

Yes, automated code review applies to engine, game, UI, and shader implementations. The system detects the file type and runs the applicable engine specialists in parallel to evaluate architecture, standards, and performance-minded game-specific concerns.

How does ADR compliance verification detect architectural drift?▼

ADR compliance verification detects architectural drift by searching the codebase for ADR references, such as ADR-NNN or architecture paths. It evaluates the code against extracted Decision and Consequences to flag drift severity or violations in a structured report.

What limitations exist when reviewing code complexity and size limits?▼

Reviewing code complexity and size limits depends on the project standards defined in CLAUDE.md. The review checks these specific documentation and size limits, requiring explicit project standards to effectively evaluate and report structural violations.

Related Skills

Explore More Software Engineering Skills→
hospitaljobsinhospitaljobsin
7

code-review-excellence

Structure code reviews with checklists and feedback templates.

Official
Intermediate
NikhilVijayakumarNikhilVijayakumar

refactor-agent

Detect architectural drift and complexity spikes from quality reports.

Community
Intermediate
eventua11yeventua11y
1

writing-tests

Automate E2E and unit test setup and execution with Playwright and Vitest.

Official
Intermediate
baphledbaphled
1

static-analysis

Guide static code analysis tools to detect bugs, vulnerabilities, and style violations.

Community
Intermediate