CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

requesting-code-review

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

Quality

70%

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 ./src-tauri/experts/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

71%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 actionable, well-sequenced guidance with concrete commands, a dispatch recipe, feedback triage rules, and a realistic worked example, at good token efficiency. Its main weakness is progressive disclosure: it twice points to a code-reviewer template file that is missing from the bundle and referenced under two different paths, so the promised navigation fails.

Suggestions

Ship the referenced template in the bundle (e.g. references/code-reviewer.md) so the central dispatch step is actually executable.

Use one consistent, correct path for the template — the body cites both `code-reviewer.md` and `requesting-code-review/code-reviewer.md` for the same file.

Add an explicit re-review step after fixes (e.g. "re-dispatch the reviewer on the fix range before continuing") to close the workflow's feedback loop.

DimensionReasoningScore

Conciseness

The body is efficient — a short rationale, exact commands, placeholder definitions, and triage rules with no explanations of concepts Claude already knows. Minor trimming is possible: "Review after EACH task" in Integration with Workflows repeats When to Request Review, and "Push back if reviewer is wrong (with reasoning)" duplicates the Red Flags section. This matches anchor 4 ("Efficient; minor instances of over-explanation that could be trimmed") rather than 5 ("every token earns its place") because of the duplicated guidance.

4 / 5

Actionability

Concrete, executable guidance throughout: copy-paste commands (`BASE_SHA=$(git rev-parse HEAD~1)`), a specific dispatch instruction ("Use Task tool with `general-purpose` type"), defined placeholders, severity-based triage rules, and a worked example with real SHAs and a grep one-liner. Not 5 because the central step depends on a template ("fill template at `code-reviewer.md`") that is not present in the bundle, leaving an execution gap.

4 / 5

Workflow Clarity

The How to Request section gives a clear numbered sequence (get SHAs → dispatch reviewer → act on feedback) with checkpoints: "Fix Critical issues immediately", "Fix Important issues before proceeding", and Never/proceed prohibitions for unfixed issues. It is not 5 because there is no explicit re-review loop after fixes — the example jumps straight to "Continue to Task 3" — and not 3 because validation checkpoints for the review feedback are explicitly present.

4 / 5

Progressive Disclosure

Sections are well-organized, but the skill's only external reference is broken: "fill template at `code-reviewer.md`" and "See template at: requesting-code-review/code-reviewer.md" point to a file that does not exist anywhere in the bundle, under two inconsistent paths. This matches anchor 3 ("Some structure but could be better organized" with problematic references) rather than 4, because a dangling, inconsistently-pathed reference to the skill's central artifact is more than a minor organization gap.

3 / 5

Total

15

/

20

Passed

Description

53%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 an explicit and reasonably natural "Use when..." trigger clause, but never mentions code review — the skill's own subject and most natural trigger term — and states no concrete action beyond the generic "verify work meets requirements". This leaves it weak on specificity and at risk of overlapping with generic verification/testing skills.

Suggestions

State the concrete action, e.g. "Dispatches a code-reviewer subagent with a tailored diff-range prompt to verify work meets requirements".

Add the natural trigger terms users would actually say: "code review", "review my code/changes", "pull request", "PR", "pre-merge check".

Narrow the overly broad trigger "completing tasks" to something more distinctive like "after completing a task or major feature in subagent-driven development" to reduce conflict with unrelated end-of-task skills.

DimensionReasoningScore

Specificity

The only stated action is the generic "verify work meets requirements"; the description names the domain (verifying dev work at task/feature/merge milestones) but never states a concrete action like dispatching a code reviewer subagent or reviewing a diff. It matches anchor 2 ("Names the domain but actions are minimal or generic") rather than 3, which requires 1-2 concrete actions, or 1, which requires pure abstraction with no discernible action.

2 / 5

Completeness

The "when" is explicit ("Use when completing tasks, implementing major features, or before merging") and a "what" is present ("to verify work meets requirements"), so both boxes are checked and the missing-"Use when" cap does not apply. It is not 5 because the "what" is thin compared to the anchor's concrete action list, and not 3 because the "when" is explicit rather than missing or weakly implied — this lands noticeably above the anchor-3 case.

4 / 5

Trigger Term Quality

"completing tasks", "implementing major features", and "before merging" are natural dev phrases, but the description omits the most natural trigger terms users would say for this skill: "review", "code review", "PR", or "pull request". This matches anchor 3 ("Some relevant keywords but missing common variations or synonyms"), not 4, because the core trigger vocabulary of the domain is absent.

3 / 5

Distinctiveness Conflict Risk

"completing tasks" is broad enough to overlap with nearly any end-of-task skill, and "verify work meets requirements" overlaps with testing/QA/validation skills; the description also never uses "code review", which is what would distinguish it. It is somewhat specific via "implementing major features" and "before merging", matching anchor 3 rather than 4 (minor overlap only) or 2 (entirely broad).

3 / 5

Total

12

/

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

arwei944/codeg

Path

src-tauri/experts/skills/requesting-code-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.