CtrlK
BlogDocsLog inGet started
Tessl Logo

requesting-code-review

Use when completing tasks, implementing major features, or before merging to verify work meets requirements

49

Quality

62%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/superpowers/skills/requesting-code-review/SKILL.md

The canonical home for this skill is requesting-code-review in obra/superpowers

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 is a well-structured, concise operational guide with an explicit workflow, triage checkpoints, and useful anti-rationalization content — but it is built around a template file (code-reviewer.md) that does not exist in the bundle, leaving its central action unexecutable and its navigation broken. Fixing the dangling reference would lift both actionability and progressive disclosure substantially.

Suggestions

Ship the referenced code-reviewer.md template in the skill directory (or move it under references/ and update the links) so the core dispatch step is actually executable — this is the single highest-impact fix.

If the template cannot be bundled, inline the template's skeleton in SKILL.md so the placeholders ({DESCRIPTION}, {PLAN_OR_REQUIREMENTS}, {BASE_SHA}, {HEAD_SHA}) have a concrete fill target.

Close the workflow loop: specify that fixes should be followed by a re-review against the new HEAD SHA, and de-duplicate the push-back guidance that currently appears in three places.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence — no explanations of what code review or git is, and every section (When/How/Example/Rationalizations/Red Flags) carries operational content. Only minor trimming opportunities exist: push-back guidance is repeated across "Act on feedback", the Rationalizations table, and "Red Flags". Not 5 because that repetition and the somewhat long Example transcript could be tightened.

4 / 5

Actionability

Concrete elements are present (executable git commands for both SHAs, the exact subagent type, a four-slot placeholder list, explicit triage rules), but the central instruction — "filling the template at code-reviewer.md" — cannot be executed because that file does not exist anywhere in the skill directory. The referenced Example block partially compensates, but a missing key artifact is more than the 'minor gaps' of anchor 4. Not 2 because the surrounding guidance is concrete and specific, unlike high-level hints.

3 / 5

Workflow Clarity

A clearly numbered three-step sequence (get SHAs → dispatch reviewer → act on feedback) with explicit checkpoints ("Fix Critical issues immediately", "Fix Important issues before proceeding") and an error-recovery path for when the reviewer is wrong. Not 5 because there is no re-review loop after fixes and no guidance on what to do if the subagent cannot be dispatched or the SHAs are wrong; not 3 because checkpoints are explicit, not merely implicit.

4 / 5

Progressive Disclosure

Section structure is good and the template reference is clearly signaled and one level deep (linked twice, once as "See template at"), but the referenced code-reviewer.md is absent from the bundle — no references/, scripts/, or assets/ directories exist and no companion file is present, so the primary navigation path is broken. Not 4 because a dangling reference defeats the disclosure structure's purpose; not 2 because the SKILL.md itself is well-organized and does not inline content that belongs elsewhere.

3 / 5

Total

14

/

20

Passed

Description

45%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 has a strong explicit 'Use when...' trigger structure with three concrete timing contexts, but it fails to state what the skill actually does — code review via a dispatched reviewer subagent is completely absent. This weakens both the 'what' half of completeness and distinctiveness against neighboring verification/testing skills. It reads more like a scheduling rule than a capability statement.

Suggestions

State the concrete capability up front, e.g. 'Dispatches a code reviewer subagent with precisely crafted context (SHAs, description, requirements) to evaluate completed work' — this fixes both specificity and the 'what' half of completeness.

Add the natural trigger terms users actually say — 'code review', 'review my code/changes', 'before merging a PR' — so the skill triggers reliably instead of competing with testing/verification skills.

Include how the review verdict is consumed (fix Critical/Important issues before proceeding) so the description's 'verify' promise is grounded in a concrete mechanism.

DimensionReasoningScore

Specificity

The only stated action is the generic "verify work meets requirements"; the skill's actual capability (dispatching a code reviewer subagent) is never named, and even the domain is only implied by "tasks", "major features", and "before merging". Not 3 because no concrete capability is listed like the anchor's 'extracts content'; not 1 because the trigger contexts are concrete rather than pure abstraction.

2 / 5

Completeness

The 'when' is explicit and well-structured ("Use when completing tasks... or before merging"), but the 'what' is only "verify work meets requirements" — vague, with no mention of code review, a reviewer subagent, or how verification happens. Falls between anchor 3 (clear what, missing when) and anchor 4 (both present); the very weak 'what' pulls it to 3.

3 / 5

Trigger Term Quality

Natural phrases like "completing tasks", "implementing major features", and "before merging" are present, but the most common phrasings a user would actually say — "code review", "review my code", "PR review" — are missing. Not 4 because the synonym coverage gap is substantial given 'code review' is the skill's core concept.

3 / 5

Distinctiveness Conflict Risk

"Completing tasks", "before merging", and "verify work meets requirements" are somewhat specific to a development workflow, but the absence of 'code review' means it could readily trigger a testing, verification, or CI skill instead. Not 4 because overlap with closely related verification/testing skills is a real risk given the generic 'verify' framing.

3 / 5

Total

11

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

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