review_skill

Overview

This skill runs a non-interactive review of uncommitted changes in the current repository using the Codex CLI. It helps surface code quality issues, potential bugs, and improvement suggestions before you commit. Use it as a quick safety check or pre-commit gate for TypeScript and other code in the repo.

How this skill works

The skill invokes the Codex CLI review command against the working tree to analyze changed files that are not yet committed. It inspects diffs, performs static analysis, and generates plain-language feedback on correctness, style, and maintainability. Results are returned in the terminal so you can apply fixes immediately or include them in your next commit.

When to use it

• Before committing a feature or fix to catch regressions early
• When asking for an automated code review from CI or a peer
• After running tests to find issues tests may not cover
• During pair programming to get a second automated opinion
• When preparing a pull request to reduce review churn

Best practices

• Run the review locally before making commits to avoid pushing obvious issues
• Address high-confidence bug warnings first, then follow style and optimization suggestions
• Review the output file-by-file and apply minimal, focused fixes
• Combine with unit tests and linters for broader coverage
• Re-run after fixes to confirm issues are resolved

Example use cases

• A developer runs the review before pushing a feature branch to catch logic errors
• A maintainer uses the tool to validate refactors across TypeScript modules
• Use the review as part of a pre-commit hook to block commits with obvious bugs
• Run the command in CI to produce automated feedback for pull requests
• Run the review when you want quick suggestions for code clarity and API use