Make /review a callable skill instead of a built-in workflow

Open 💬 2 comments Opened May 22, 2026 by stewartadam

What variant of Codex are you using?

CLI

What feature would you like to see?

/review is currently part of the CLI harness and only callable by users. It would be nice if /review was a skill that could be called by agents, so that reviews can be included as a part of workflows defined in AGENTS.md, other skills, or by agents orchestrating other agents.

Additional information

_No response_

View original on GitHub ↗

2 Comments

yui-stingray · 3 months ago

I took a quick look at current origin/main (7d47056). One useful boundary for this request may already exist: the app-server protocol documents review/start, and the TUI /review flow appears to ultimately route through that RPC.

The current flow I found is roughly:

/review is parsed as SlashCommand::Review in the TUI.
The no-arg command opens the review popup; inline custom review text submits AppCommand::review(ReviewTarget::Custom { ... }).
AppCommand::Review is routed in thread_routing.rs to app_server.review_start(thread_id, target).
AppServerSession::review_start sends ClientRequest::ReviewStart with ReviewDelivery::Inline.
The app-server side dispatches ClientRequest::ReviewStart to turn_processor.rs::review_start / review_start_inner.
There is v2 coverage in app-server/tests/suite/v2/review.rs, including review_start_runs_review_turn_and_emits_code_review_item.

So if the goal is to make review callable by agents or workflows, a smaller implementation path might be to wrap or reuse the existing review/start app-server request as the callable surface, subject to whatever boundary the skill/tool system should expose, rather than reimplementing the reviewer as an independent skill from scratch.

stewartadam · 2 months ago

Ah, workaround: the code review sub-agent is based on the prompt in this file: https://github.com/openai/codex/blob/main/codex-rs/prompts/templates/review/rubric.md

You can just ask Codex to turn that into a callable skill and away you go. I can now ask for$pr-review in other apps like Conductor and it will perform the same high-quality code reviews you get from the Codex CLI.