CtrlK
BlogDocsLog inGet started
Tessl Logo

receiving-code-review

Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation

73

1.34x
Quality

58%

Does it follow best practices?

Impact

97%

1.34x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/receiving-code-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

40%

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 clear 'when' clause which is its strongest element, but it fundamentally fails to describe what the skill actually does — it only describes a philosophy (technical rigor over blind agreement). The absence of concrete actions makes it difficult for Claude to know what this skill produces or how it helps, and the description reads more like a behavioral guideline than a skill capability statement.

Suggestions

Add concrete actions describing what the skill does, e.g., 'Critically evaluates code review feedback for technical accuracy, verifies suggestions against codebase context, and formulates reasoned responses before implementing changes.'

Include more natural trigger term variations such as 'PR comments', 'pull request review', 'reviewer suggestions', 'code review response', 'review feedback'.

Reframe the description to lead with capabilities rather than anti-patterns — state what it does positively before noting what it avoids.

DimensionReasoningScore

Specificity

The description does not list any concrete actions. It describes a mindset ('technical rigor and verification') and anti-patterns ('not performative agreement or blind implementation') but never states what the skill actually does — no verbs like 'analyze', 'verify', 'compare', or 'respond'.

1 / 3

Completeness

The 'when' is explicitly addressed ('Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable'). However, the 'what' is essentially absent — it describes what NOT to do but never states what the skill actually does or produces.

2 / 3

Trigger Term Quality

It includes some relevant trigger terms like 'code review feedback', 'implementing suggestions', and 'technically questionable', which a user might naturally mention. However, it misses common variations like 'PR review', 'pull request', 'reviewer comments', 'code comments', or 'review response'.

2 / 3

Distinctiveness Conflict Risk

The focus on code review feedback response is a reasonably specific niche, but the lack of concrete actions makes it potentially overlap with general code review skills, code analysis skills, or communication/response skills.

2 / 3

Total

7

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a strong behavioral skill that provides genuinely useful, non-obvious guidance for handling code review feedback with technical rigor. Its main strengths are excellent actionability (concrete examples, decision trees, specific phrases) and clear workflow sequencing with validation checkpoints. Its main weakness is moderate repetition across sections — the forbidden responses, correct acknowledgment, common mistakes, and real examples sections overlap significantly, which inflates token cost without proportional value.

Suggestions

Consolidate the 'Forbidden Responses', 'Acknowledging Correct Feedback', 'Common Mistakes', and 'Real Examples' sections to eliminate redundancy — a single 'Response Patterns' section with a good/bad table and 2-3 examples would cover all of this more efficiently.

Consider extracting the detailed real examples into a separate EXAMPLES.md file to keep the main skill leaner and improve progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is mostly efficient and covers genuinely useful behavioral guidance Claude wouldn't inherently know (specific forbidden phrases, pushback protocols, YAGNI checks). However, it's somewhat repetitive — the 'Acknowledging Correct Feedback' and 'Forbidden Responses' sections overlap, and the 'Common Mistakes' table largely restates earlier content. The real examples section also partially duplicates inline examples. Could be tightened by ~30%.

2 / 3

Actionability

Highly actionable with concrete examples of good vs bad responses, specific pseudocode workflows for decision-making, exact phrases to use and avoid, a clear implementation order, and even a specific GitHub API command for thread replies. The skill provides copy-paste-ready response patterns and decision trees.

3 / 3

Workflow Clarity

Clear multi-step sequences with explicit validation checkpoints: the main response pattern (READ→UNDERSTAND→VERIFY→EVALUATE→RESPOND→IMPLEMENT), the unclear feedback handling (STOP before implementing), the external reviewer checklist (5 verification steps before implementing), and the implementation order (clarify→blocking→simple→complex→test→verify regressions). Feedback loops are present (push back → corrected → acknowledge factually).

3 / 3

Progressive Disclosure

The content is well-structured with clear headers and logical sections, but it's a fairly long monolithic document (~180 lines) with no references to external files. Some sections like the detailed real examples or the common mistakes table could be split out. However, as a standalone skill with no bundle, the organization is reasonable — just on the edge of being too much inline content.

2 / 3

Total

10

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
obra/superpowers
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.