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

51

Quality

64%

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
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 is an efficient, actionable instruction skill with a clear workflow, explicit feedback-triage rules, and good use of tables and examples. Its main defects are the missing code-reviewer.md template file (referenced twice but absent from the bundle) and the absence of a re-review loop after fixes.

Suggestions

Add the missing code-reviewer.md template file to the bundle — the entire dispatch step depends on it and currently cannot be executed.

Add an explicit re-review step after applying fixes (e.g., "After fixing Critical/Important issues, dispatch the reviewer again on the fix commits") to close the feedback loop.

Remove the duplicate reference to code-reviewer.md at the end of the body to tighten the token budget.

DimensionReasoningScore

Conciseness

The body is lean and imperative with no explanations of concepts Claude already knows; tables and command blocks carry the weight. Minor trims are possible — the link to code-reviewer.md appears twice ("[Dispatch code reviewer subagent]" sections at top and "See template at" at bottom) and the example block runs slightly long — fitting anchor 4 rather than 5.

4 / 5

Actionability

Concrete copy-paste commands ("BASE_SHA=$(git rev-parse HEAD~1)"), defined placeholders, an illustrative filled-in dispatch example, and explicit triage rules ("Fix Critical issues immediately") make the guidance mostly executable. The gap keeping it from 5: step 2 depends on the template at code-reviewer.md, which is not present in the bundle, so the central dispatch step cannot be executed as written.

4 / 5

Workflow Clarity

A clear three-step sequence (get SHAs → dispatch reviewer → act on feedback) with explicit checkpoints ("Fix Important issues before proceeding"), red-flag checklists, and push-back guidance. It falls short of anchor 5 because there is no re-review loop after fixes are applied — the workflow proceeds to the next task without validating that raised issues were resolved.

4 / 5

Progressive Disclosure

Sections are well-organized and the sole reference is one level deep and clearly signaled ("[code-reviewer.md](code-reviewer.md)"), but that referenced file does not exist in the bundle — there are no references/, scripts/, or assets/ directories and no code-reviewer.md anywhere. Scored against the actual bundle structure, the workflow's core artifact is dangling, which is a more serious organization failure than the minor gaps of anchor 4.

3 / 5

Total

15

/

20

Passed

Description

41%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 a pure trigger clause with no statement of what the skill does. Its 'Use when...' triggers are natural but overly broad ("completing tasks") and miss the skill's own core vocabulary — code review — creating both a completeness gap and conflict risk with adjacent verification skills.

Suggestions

State the 'what' explicitly, e.g. "Dispatches a code-reviewer subagent with precisely crafted context to verify work meets requirements. Use when..."

Add the skill's core trigger terms: "code review", "review my changes/PR", and "before merging to main".

Narrow the overly broad "completing tasks" trigger to specific moments (after each subagent task, after a major feature, before merge) to reduce overlap with generic testing/QA skills.

DimensionReasoningScore

Specificity

The only action-adjacent phrase is "verify work meets requirements", which is generic; the description never states the concrete mechanism (dispatch a code-reviewer subagent) that the skill body actually performs. It names the general domain (task completion/merging verification) but the actions are minimal and generic, matching anchor 2 rather than 3 because no concrete action is explicitly stated.

2 / 5

Completeness

The 'when' is explicit and multi-triggered ("Use when completing tasks, implementing major features, or before merging"), but the 'what' is only weakly implied by "to verify work meets requirements" — the skill actually dispatches a code-reviewer subagent, which is nowhere stated. Per anchor 3, a clear 'what' with a missing/weakly-implied counterpart caps this at 3; it cannot reach 4 because the 'what' is barely present.

3 / 5

Trigger Term Quality

Triggers like "completing tasks", "implementing major features", and "before merging" are natural, but the most obvious phrases a user would say for this skill — "code review", "review my code", "PR review" — are entirely absent. Some relevant keywords exist but common variations and synonyms are missing, fitting anchor 3.

3 / 5

Distinctiveness Conflict Risk

"Completing tasks" is extremely broad and would fire on nearly any development moment, and the absence of any "code review" niche term means high overlap with testing, QA, and general verification skills. This matches anchor 2 ("very broad; high overlap risk with many similar skills") rather than 3, because the description carves out no distinguishable trigger niche.

2 / 5

Total

10

/

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

obra/superpowers

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.