Codex critical-review skill setup and severity-ranked code review
Review a change against its acceptance criteria and report evidence-based findings across correctness, design, readability, and tests. Group findings by severity with a location, impact, and suggested fix.
中文Install in Codex
A Codex project workspace. The sample includes the changed expression, acceptance criterion, and observation for a severity-ranked code review.
- Review `.agents/skills/critical-review/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.agents/skills/critical-review/` in your project and save the reviewed file as `.agents/skills/critical-review/SKILL.md`.
- Start Codex from that project's root, then type `$critical-review` and select the matching skill.
Example task
Invoke critical-review to review this fictional order totals change.
case data `order_totals_test` | acceptance=sum all items
file `order_totals.py` | changed expression `sum(items[1:])`
input `items=[3]` | observed `total=0` | expected `total=3`What to check
Report the skipped first item in `order_totals.py` as a `Blocker`. For `items=[3]`, the observation is `total=0` and acceptance requires `total=3`. Suggest fixing the sum range and keeping this boundary case.
Original SKILL.md on GitHub · Updated
Frequently asked question
How do I make a review finding actionable?
Group findings by severity and give the changed location, the impact, and a verifiable fix. The sample affects the correctness of the order total.