skills.rest
mistakenot
mistakenotCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

request-codex-review

Runs a Codex code review of task planning docs and resolves the resulting comments.

Updated Apr 17, 2026
Search Tags:#workflow#code review#codex#task planning#review comments#cli automation
One-click install
npx skills add https://github.com/mistakenot/skills --skill request-codex-review-mistakenot
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: request-codex-review
Source: https://github.com/mistakenot/skills/tree/main/plugins/planning-workflow/skills/request-codex-review
Command: npx skills add https://github.com/mistakenot/skills --skill request-codex-review-mistakenot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Getting a second pair of eyes on task planning documents before execution requires manual copy-pasting into review tools and tracking feedback by hand. This Skill automates sending task docs to Codex for review, counting the comments it leaves, and resolving each thread through a structured append-only workflow. ## Core Features & Use Cases - Automated Codex Review: Invokes codex exec against the task folder in docs/tasks/ with correct stdin handling so the review runs unattended without hanging. - Comment Detection and Verification: Counts review threads in both Markdown (UNRESOLVED/RESOLVED/REJECTED comments) and HTML (<pd-thread> elements) formats, then verifies author replies exist after resolution. - Failure Diagnosis: Detects non-zero exit codes, empty reviews, and renamed CLI flags, directing you to check codex exec --help or run auto skill update for vendored copies. - Use Case: After drafting a plan with /new-task, run this Skill to have Codex review the plan, then automatically invoke /resolve-comments so every P1/P2/P3 thread is addressed before execution begins. ## Quick Start Ask the agent to request a Codex review for task 042 and resolve any comments it leaves.

Frequently Asked Questions about request-codex-review

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

FAQPage Schema
How do I get Codex to review my task planning docs?▼

Provide the numeric task ID and repository root, and the Skill locates the matching folder under docs/tasks/, then runs codex exec with the review-task prompt. It redirects stdin from /dev/null so codex does not hang waiting for piped input.

How are Codex review comments resolved after the review?▼

After a successful review with comments, the Skill invokes /resolve-comments with the task ID in the current agent context. Comment threads are append-only, so resolution adds author replies rather than editing or deleting existing comments.

Why does codex exec hang when run in the background?▼

codex exec reads its prompt from stdin whenever stdin is a pipe, blocking until EOF even when a prompt argument is supplied. Redirecting stdin from /dev/null gives an immediate EOF so the prompt argument is used directly.

What review comment formats does it support?▼

It supports Markdown files using HTML comments tagged UNRESOLVED, RESOLVED, or REJECTED with P1/P2/P3 priorities, and HTML planning docs using pd-thread and pd-comment elements from the pd-components library. The format is chosen by file extension.

What happens when Codex fails or leaves no comments?▼

The Skill checks the exit code and comment count, then tails the review log for diagnosis. If the log shows an unexpected argument error, the installed codex CLI likely renamed a flag, and you should check codex exec --help or run auto skill update.

Related Skills

Explore More Software Engineering Skills→
princejoogieprincejoogie
30

overseer-plan

Convert Markdown planning documents into Overseer tasks with MCP codemode.

Community
Advanced
jon23djon23d
3

worktrees

Create isolated Git worktrees per ticket and manage PR lifecycle.

Community
Advanced
OpenRouterTeamOpenRouterTeam
7

resolve-pr-comments

Resolve GitHub PR review threads by fixing, declining, or escalating each comment.

Official
Advanced
primovera12primovera12

kit-autopilot

Automate unattended kit planning with multi-account rotation and deterministic restarts.

Community
Advanced