local-codex-review

Run deterministic local code reviews via Codex CLI on git diffs.

1|Updated May 27, 2026
One-click install
npx skills add https://github.com/nanomader/codex-workflow-skills --skill local-codex-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: local-codex-review
Source: https://github.com/nanomader/codex-workflow-skills/tree/main/local-codex-review
Command: npx skills add https://github.com/nanomader/codex-workflow-skills --skill local-codex-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Run a local, deterministic code review by delegating to the Codex CLI with an explicit git-diff context. This enables targeted reviews of uncommitted changes, a branch diff, or a specific commit, while producing auditable findings.

Core Features & Use Cases

  • Deterministic, patch-scoped reviews via codex exec with a defined diff target.
  • Output validated against the review schema, with findings saved to Markdown for triage.
  • Supports multiple review targets (--uncommitted, --tracked-head, --base-ref, --commit) and configurable severity filtering.
  • Reproducible results with artifacts and optional JSON output for integration.

Quick Start

Run a local Codex review against a chosen diff target (uncommitted, tracked-head, base-ref, or commit) and save findings as Markdown.

Frequently Asked Questions about local-codex-review

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

FAQPage Schema
How do I run a deterministic local code review on a git diff?▼

To run a deterministic local code review, invoke Codex with an explicit git-diff context targeting uncommitted changes, branch diffs, or specific commits to generate structured findings for triage.

Can I automate code reviews for uncommitted changes and save the output as JSON?▼

Yes, you can automate code reviews for uncommitted changes by executing a patch-scoped review with Codex, which validates output against a review schema and optionally saves findings as JSON.

What is the best way to review a specific git commit locally before pushing?▼

The best way to review a specific git commit locally is using a diff-scoped prompt with Codex that enforces deterministic execution and saves schema-validated findings to Markdown for triage.

Does this local code review approach work with branch diffs and severity filtering?▼

Yes, this local code review approach supports branch diffs via base-ref targets and includes configurable severity filtering to manage the structured findings saved during the review process.

How does schema-validated output improve automated code review triage?▼

Schema-validated output improves automated code review triage by enforcing a structured JSON format for findings, ensuring reproducible results that integrate seamlessly into downstream development workflows.

What are the limitations of using deterministic execution for local code reviews?▼

Deterministic execution for local code reviews requires explicit git-diff context to function properly, limiting its scope to patch-specific analysis rather than evaluating the entire repository architecture.