codex-review
Send code to Codex for deep review and bug finding. Use this PROACTIVELY after writing significant code, completing implementations, or when complex code needs analysis. Also use when user explicitly says codex review, delegate review, or wants thorough code analysis.
Security Assessment
About codex-review
The 'codex-review' skill is designed to facilitate in-depth code reviews by leveraging the Codex agent running within a tmux session. It ensures that code is thoroughly examined for bugs, security vulnerabilities, edge cases, logic errors, and performance issues. This skill uses tmux file-based IPC (Inter-Process Communication) to send code to Codex for analysis, making it ideal for environments where dual-pane tmux setups are used. It allows developers to streamline their review process and get insights directly from Codex without having to manually examine large codebases themselves.
The core feature of this skill is the seamless interaction with Codex within tmux, starting from verifying the tmux environment to gathering code for review and triggering Codex. Users specify what code to review—whether individual files, recent changes, or code blocks—and the skill automatically prepares a task request, sends it to Codex, and then monitors Codex's progress. Once the review is complete, it presents the results to the user, making it easy for them to assess their code. The skill is particularly beneficial for users working with complex code or requiring security and bug analysis. It's tailored for developers who need to optimize and secure their codebase quickly and efficiently.
Use cases for the 'codex-review' skill include developers working on large codebases who need to quickly assess code for bugs or vulnerabilities, those looking to improve code performance, or anyone needing an expert review on edge cases. It targets users in the development community who already utilize tmux for their development workflow and want to automate the review process with Codex.
FAQ
What happens if I try to use 'codex-review' outside of tmux?
The skill will not work outside of tmux. You will be prompted with a message instructing you to either use the 'review this code with codex' command or to enter tmux to proceed with the review.
Can I use this skill without a project root?
No, the skill requires the presence of a `.agent-collab` directory in the project root. If it's missing, the skill will ask you to provide the project root.
What types of code can be reviewed using this skill?
The skill can review any code accessible within the tmux environment. Users can specify individual files, recent changes, or even code blocks to be reviewed.
How does the review process work once I trigger Codex?
Once the task is created and sent to Codex, the skill waits for Codex to complete the review. Background polling is used to monitor Codex’s progress. When the review is complete, the results are automatically presented to you.
Is there a way to customize the areas of focus for the review?
Yes, users can specify areas of focus such as bugs, security vulnerabilities, performance issues, or any specific concerns they want Codex to address in the task request.
Install codex-review
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
antorsae/dual-agent