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

65%

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 ./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 delivers a clear, actionable review-request workflow with sensible triage rules and guardrails, and it mostly respects the reader's intelligence. Its main defects are a padded example section that duplicates the instructions and a dangling reference to a template file that does not exist in the bundle.

Suggestions

Ship the referenced 'code-reviewer.md' template as a bundle file (e.g. references/code-reviewer.md) or inline its content, since the dispatch step is unexecutable without it

Trim the ~25-line Example transcript to a short filled-in dispatch (or drop it) — the placeholders section already conveys the same information

Merge the 'If reviewer wrong' bullets with step 3's push-back guidance to remove the duplicated advice, and give a concrete rule for choosing BASE_SHA instead of 'HEAD~1 or origin/main'

DimensionReasoningScore

Conciseness

Most sections are lean, but the ~25-line Example transcript largely restates the 'How to Request' placeholders as a roleplay, and the 'If reviewer wrong' bullets duplicate step 3's 'Push back if reviewer is wrong (with reasoning)'. Mostly efficient with some unnecessary content matches anchor 3; not 4 because the example is a whole padded section rather than a minor instance.

3 / 5

Actionability

Concrete commands ('git rev-parse HEAD~1', 'git rev-parse HEAD'), a named subagent type, enumerated placeholders, and explicit triage rules make the guidance mostly executable. Not 5 because step 2 directs the reader to fill a template at 'code-reviewer.md' that does not exist in the skill bundle, so the dispatch step cannot be executed as written.

4 / 5

Workflow Clarity

The three-step sequence (get SHAs → dispatch reviewer → act on feedback) is clearly sequenced with explicit checkpoints ('Fix Critical issues immediately', 'Fix Important issues before proceeding') and an error-recovery path (push back with technical reasoning). Not 5 because BASE_SHA selection is left loose ('HEAD~1 or origin/main') and the dispatch step depends on the missing template file.

4 / 5

Progressive Disclosure

The single file is well-sectioned, but it points twice to a template file ('fill template at code-reviewer.md', 'See template at: requesting-code-review/code-reviewer.md') that is absent from the bundle — a dangling reference for what is essentially the skill's core payload. Some structure with a problematic reference matches anchor 3; not 4 because the one external dependency it declares is unusable.

3 / 5

Total

14

/

20

Passed

Description

50%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 trigger structure but never states what the skill actually does — code review itself is absent from the text. Both the 'what' and the distinctiveness suffer from this omission, leaving it reading like a generic verification trigger.

Suggestions

Name the core action in the 'what' clause, e.g. 'Request code review on completed work by dispatching a code-reviewer subagent with precise git SHAs'

Add the natural trigger phrases users actually say — 'code review', 'review my code', 'PR review' — to the 'Use when' clause

Drop or narrow the fully generic 'completing tasks' trigger, which conflicts with nearly every development-workflow skill

DimensionReasoningScore

Specificity

No concrete action is ever named — the description never mentions code review, dispatching a reviewer, or reviewing diffs; the only action-ish phrase is the generic 'verify work meets requirements'. This sits between anchor 1 (entirely vague) and anchor 3 (1-2 concrete actions), matching anchor 2's minimal/generic action coverage.

2 / 5

Completeness

The 'when' is explicit and well-structured ('Use when completing tasks, implementing major features, or before merging'), and a 'what' is present ('verify work meets requirements'), but that 'what' states only a purpose, not the actual action (dispatching a code-review subagent). Matches anchor 4's pattern of both present with one under-specified; not 3 because the 'when' clause is strong rather than weakly implied.

4 / 5

Trigger Term Quality

Phrases like 'completing tasks', 'implementing major features', 'before merging', and 'verify work' are relevant workflow triggers, but the natural terms users would actually say — 'code review', 'review my code', 'PR review', 'feedback' — are all missing.

3 / 5

Distinctiveness Conflict Risk

'Completing tasks' is fully generic and would overlap with virtually any workflow skill (testing, commit messages, plan execution, verification); only 'before merging' narrows the scope slightly. High overlap risk matches anchor 2; not 3 because the trigger set as a whole is dominated by the generic opening condition.

2 / 5

Total

11

/

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

valeriibeck-star/claude-skills

Path

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.