CtrlK
BlogDocsLog inGet started
Tessl Logo

review-agent

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

72

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 content is an efficient, well-structured instruction-only skill: a concrete review workflow with explicit validation gates, concrete git commands, and a precise output specification, all with no padding. The only soft spot is that the central defect-detection work relies on judgment rather than scripted steps.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — it never explains what a diff or a merge-base is, and every line (numbered steps, flag criteria, priority codes, output format) earns its place, matching anchor 5.

5 / 5

Actionability

It provides concrete executable commands ('git merge-base HEAD <comparison-ref>', 'git diff <merge-base-sha>'), an exact finding-title format, and P0-P3 definitions, but the core defect-finding activity is inherently judgment-based rather than copy-paste scriptable, so it sits at anchor 4 with minor gaps.

4 / 5

Workflow Clarity

A clear four-step numbered sequence is paired with an explicit confirmation checkpoint ('Check the relevant tests and call sites to confirm that each finding is real') and a five-bullet flag-criteria gate; as a read-only, single-purpose skill under ~50 lines it qualifies for the simple-skill exception, matching anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist and none are needed; the body is a single well-organized SKILL.md with clear section headers ('Review the change', 'Write the result'), so under the under-50-lines / no-external-references exception it matches anchor 5.

5 / 5

Total

19

/

20

Passed

Description

83%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 well-crafted: it states the skill's purpose and a concrete, multi-scenario trigger in third person without padding. Both 'what' and 'when' are explicit and distinctive, with only minor gaps in action specificity and trigger synonyms.

DimensionReasoningScore

Specificity

Names the domain and concrete actions — 'Perform a read-only, defect-first review of a specified code change and return every actionable finding' — but coverage is two core actions with modifiers rather than a comprehensive list, so it sits at anchor 4 rather than 5.

4 / 5

Completeness

It explicitly answers both what ('read-only, defect-first review... return every actionable finding') and when ('Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions') with concrete trigger phrases, matching anchor 5.

5 / 5

Trigger Term Quality

The 'Use when' clause lists natural delegation phrases ('uncommitted changes, a base-branch diff, a commit, or custom review instructions') a user or agent would say, giving good keyword coverage with only minor synonyms missing, matching anchor 4.

4 / 5

Distinctiveness Conflict Risk

The 'delegated read-only review of a specified code change' framing carves a clear niche with mostly distinct triggers, but it has minor overlap with general code-review skills, placing it at anchor 4 rather than 5.

4 / 5

Total

17

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
openai/codex
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.