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.