gaia-code-review

Review story files and update the review gate with PASS or FAILED mappings.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-code-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-code-review
Source: https://github.com/gaiastudio-ai/gaia-public/tree/main/plugins/gaia/skills/gaia-code-review
Command: npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-code-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Automates a rigorous pre-merge review process to catch issues before code integration, reducing risk of defects and regressions.

Core Features & Use Cases

  • Read-only fork context ensures safety while verifying that the targeted story file exists and is in review status.
  • Verifies story file via canonical glob docs/implementation-artifacts/{story_key}-*.md.
  • Produces a machine-readable verdict (APPROVE or REQUEST_CHANGES) and updates the Review Gate via review-gate.sh.
  • Enforces architecture conformance and design fidelity checks against existing planning artifacts.

Quick Start

Invoke /gaia-code-review with a story-key to start the pre-merge review.

Frequently Asked Questions about gaia-code-review

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

FAQPage Schema
How do I automate a pre-merge code review for a pull request?

Automating a pre-merge code review involves verifying changed files for correctness and security before integration. This Skill performs read-only reviews on designated story artifacts, outputting an APPROVE or REQUEST_CHANGES verdict to a review gate.

What is a pre-merge code review process for story artifacts?

A pre-merge code review process verifies changed files against planning artifacts for correctness and test coverage. It operates in a read-only context, checking story status and updating the review gate with PASS or FAILED mappings.

How do I ensure pull request quality assurance without write access?

Pull request quality assurance can run safely in a read-only fork context using Read, Grep, Glob, and Bash tools. This restricts modifications while analyzing code for security, performance, and architecture conformance.

Can I enforce architecture conformance checks before merging code?

Architecture conformance checks are enforced by comparing changed files against existing planning artifacts. The review validates design fidelity and updates a review gate script with the final PASS or FAILED verdict.

How do I run a code review gate script for a specific story key?

Running a review gate script requires invoking the review process with a specific story-key. It locates the canonical story file via a glob pattern, verifies its status is in review, and executes the gate script.

What are the limitations of using a read-only context for code reviews?

The limitation of a read-only context is that it cannot automatically fix issues, only identify them. It restricts tool usage to Read, Grep, Glob, and Bash, meaning developers must manually address any REQUEST_CHANGES verdicts.