CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

qodo-review

Review local changes with Qodo during substantive coding milestones and before a PR or completed-work handoff. Use light background checkpoints while coding, collect and assess findings with session context, and run a final review before handing off. Also use for "review my local diff", "pre-PR review", or "run qodo review". Use qodo-review-resolver for findings already posted on a PR.

Quality

84%

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

81%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.

A highly actionable, validation-rich workflow document with executable scripts and well-organized one-level-deep references. Its main weakness is token efficiency: policy restatement across sections and duplicated shell snippets make the body noticeably longer than the content requires.

Suggestions

Consolidate the depth-selection policy into the 'Choose when and how deeply to review' section and reference it from 'Checkpoints and final handoff', 'Configuration', and 'Submit and collect with --async' instead of restating the rules in each place.

Define the merge-base resolution snippet (with its error message) once and reuse it; the identical three-line pattern currently appears in the Quick start and both async examples.

Move secondary protocol detail — the async cost/retention/operation-id semantics and the MCP stream_id/schema rules — into reference files alongside the existing connected-progress.md and finding-results.md, keeping the body to the main CLI lifecycle.

DimensionReasoningScore

Conciseness

Nearly every sentence carries non-obvious, CLI-specific operational rules rather than explanations of concepts Claude already knows, but the ~490-line body restates the depth-selection policy in four sections ("Choose when and how deeply to review", "Checkpoints and final handoff", "Configuration", "Submit and collect with --async") and repeats the identical merge-base error snippet three times. Not 2 because there is no known-concept padding, but not 4 because the redundancy goes beyond minor and could be tightened substantially.

3 / 5

Actionability

Copy-paste-ready POSIX commands throughout: version probe, whoami with full provenance flags, merge-base resolution with error handling, a complete async submit/collect loop with mktemp/trap/jq and exit-code handling, and a concrete context JSON example with field-level semantics. Not 4 because the examples cover the common cases (checkpoint, final auto, justified deep, async, connected) and are executable as written; the "examples here are illustrative" caveat is paired with an explicit offline confirmation step.

5 / 5

Workflow Clarity

The full lifecycle is sequenced — version gate first, preflight (auth, base, context), path selection, submission, collection, assessment, fix, verify, re-review — with explicit validation at each step (exit-code table, retry_after polling, bounded single-retry recovery, incomplete-coverage reporting, "recheck findings against current code"). Not 4 because validation checkpoints and feedback loops are pervasive rather than mostly present; the destructive/batch cap does not apply since verification is abundant.

5 / 5

Progressive Disclosure

Seven clearly-signaled, one-level-deep references (skill-updates.md, windows-shells.md, windows-launcher.md, review-turn-context.md, connected-progress.md, finding-results.md, local-triage.md), all verified present and none chaining into further reference files. Not 5 because substantial protocol detail — the async cost/retention/id semantics and the MCP stream_id and schema rules — is inlined in SKILL.md where it could be split out; not 3 because existing references are well-signaled and section structure is good.

4 / 5

Total

17

/

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.

A strong description: concrete actions, explicit when-to-use guidance with quoted natural triggers, and explicit disambiguation from the sibling qodo-review-resolver skill. The only weakness is that trigger coverage misses a few common synonyms for review requests.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Use light background checkpoints while coding", "collect and assess findings with session context", "run a final review before handing off" — with only mild vagueness in "substantive coding milestones". Not 5 because the action list is process-level rather than comprehensively concrete; not 3 because four-plus specific actions are named beyond merely identifying the domain.

4 / 5

Completeness

Explicitly answers both what ("Review local changes with Qodo", "collect and assess findings", "run a final review") and when ("during substantive coding milestones and before a PR or completed-work handoff", plus the quoted trigger phrases). Not 4 because the 'when' is explicit and includes concrete trigger phrases rather than being weakly implied.

5 / 5

Trigger Term Quality

Quotes natural user utterances — "review my local diff", "pre-PR review", "run qodo review" — plus domain terms like "local changes" and "PR". Not 5 because common synonyms such as "review my changes" or "check my diff" are absent; not 3 because multiple natural phrases users would actually say are present, not just generic domain keywords.

4 / 5

Distinctiveness Conflict Risk

Clear niche (Qodo local review) with explicit boundary delimitation — "Use qodo-review-resolver for findings already posted on a PR" — which resolves the nearest sibling conflict. Not 5 because generic phrasing like "review my local diff" could also match a host's built-in code-review skill; not 3 because the closest related skill is explicitly disambiguated and the tool is named.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (501 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

qodo-ai/qodo-skills

Path

codex-packages/qodo/skills/qodo-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.