CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codex-review

Code review workflows with Codex CLI including automated reviews, diff analysis, and PR improvements. Use for code review, quality checks, or automated improvement suggestions.

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/codex-review/SKILL.md

The canonical home for this skill is codex-review in fernandezbaptiste/Skrillz

SKILL.md
Quality
Evals
Security

Quality

Content

61%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers concrete, executable commands organized under clear task-based sections, but it promotes running with --dangerously-bypass-approvals-and-sandbox to auto-fix code and create commits with no validation or feedback loop. The stale version stamp and a duplicated PR section further reduce token efficiency.

Suggestions

Add validation checkpoints to the destructive workflows: after any auto-fix or commit step, show a verification loop (e.g., run tests, inspect git diff, confirm before codex apply) instead of fully bypassed approvals.

Remove or relocate the 'Last Updated: December 2025 (GPT-5.2 Release)' line into a deprecated/versioning section, since stale time-sensitive information in the main body penalizes conciseness.

Merge the 'PR Automation' section with 'Git Diff Review' to eliminate the near-duplicate gh pr view review examples, and define $PR_NUMBER (or inline a concrete PR number) so commands are fully executable.

DimensionReasoningScore

Conciseness

The body is mostly lean command blocks, but "Last Updated: December 2025 (GPT-5.2 Release)" is time-sensitive information outside any deprecated/old-patterns section, and the PR Automation section substantially repeats Git Diff Review content. This fits 'mostly efficient but some unnecessary content that could be tightened' rather than the minor-trim level of 4.

3 / 5

Actionability

Commands are concrete and mostly copy-paste ready (codex exec invocations, gh pr view, git add -p, an executable bash function). Minor gaps keep it from 5: $PR_NUMBER is never assigned, --json is used inconsistently, and piping git diff into codex exec assumes stdin is read without stating it.

4 / 5

Workflow Clarity

Destructive and batch operations ("auto-fix all issues found", "Create clean git commits", codex apply) run without validation checkpoints; the "Review before applying" snippet is the only verification touch. Per the rubric's cap, unvalidated destructive/batch workflows cannot score above 3 even though sections are clearly organized.

3 / 5

Progressive Disclosure

The single-file structure uses clear, well-ordered section headers and requires no external references. The duplication between Git Diff Review and PR Automation is a minor organization gap, and at ~100 lines the body exceeds the under-50-line exception that would allow a 5.

4 / 5

Total

14

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is a solid third-person statement with a clear domain, three concrete capabilities, and an explicit 'Use when' trigger clause. Its main weaknesses are a 'when' clause that mirrors the 'what' and trigger terms broad enough to overlap generic code-review skills.

DimensionReasoningScore

Specificity

"automated reviews, diff analysis, and PR improvements" lists several specific actions in the code-review domain, matching the 'several specific actions; minor gaps' anchor. Not 5 because coverage omits other capabilities shown in the body (report generation, applying fixes), and not 3 since it goes beyond naming just 1-2 actions.

4 / 5

Completeness

Both 'what' (automated reviews, diff analysis, PR improvements) and 'when' (explicit "Use for" clause) are present. Not 5 because the 'when' mostly restates the 'what' rather than offering concrete, distinct trigger phrases.

4 / 5

Trigger Term Quality

"Use for code review, quality checks, or automated improvement suggestions" provides good natural keyword coverage. Not 5 because common variations like "review my diff", "PR feedback", or "review staged changes" are missing.

4 / 5

Distinctiveness Conflict Risk

"with Codex CLI" establishes a clear niche, but triggers like "code review" and "quality checks" would also fire for generic code-review requests, creating minor overlap with closely related skills.

4 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

fernandezbaptiste/Skrillz

Path

.claude/skills/codex-review/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.