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.

This description clearly communicates when to use the skill (receiving code review feedback) but completely fails to describe what the skill actually does — it reads more like a philosophical stance than a capability description. The lack of concrete actions (e.g., 'verifies technical accuracy of review comments', 'analyzes suggested changes for correctness') makes it impossible to understand the skill's output or value.

Suggestions

Add concrete actions describing what the skill does, e.g., 'Evaluates code review feedback for technical accuracy, verifies suggested changes against codebase context, and identifies potentially incorrect or misleading reviewer comments.'

Expand trigger terms to include common variations like 'PR review', 'pull request comments', 'reviewer suggestions', 'code review comments', 'review feedback'.

Rewrite in third person with action verbs (e.g., 'Analyzes and verifies code review feedback...') instead of the current imperative/instructional voice ('Use when...').

DimensionReasoningScore

Specificity

The description does not list any concrete actions or capabilities. 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 'analyzes', 'verifies', 'compares', or 'generates'.

1 / 3

Completeness

The 'when' is explicitly addressed ('Use when receiving code review feedback, before implementing suggestions...'), but the 'what' is essentially absent — it never explains what concrete actions or outputs the skill produces. It only describes a philosophy or approach.

2 / 3

Trigger Term Quality

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

2 / 3

Distinctiveness Conflict Risk

The focus on code review feedback gives it a somewhat specific niche, but the lack of concrete actions means it could overlap with general code review skills, code analysis skills, or any skill that deals with evaluating suggestions. The philosophical framing ('technical rigor') doesn't help distinguish it from other code-related 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/process skill with excellent actionability and workflow clarity. It provides concrete decision trees, specific examples of correct vs incorrect behavior, and clear validation checkpoints. The main weaknesses are moderate redundancy across sections (particularly around performative agreement) and the monolithic structure that could benefit from splitting detailed examples and reference material into supporting files.

Suggestions

Consolidate the overlapping 'Forbidden Responses', 'Acknowledging Correct Feedback', and 'Real Examples' sections to reduce redundancy — the 'no performative agreement' point is made at least 4 times.

Consider extracting the detailed real examples and common mistakes table into a separate reference file to keep the main SKILL.md more concise and improve progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is mostly efficient and well-structured, but has some redundancy — the 'Forbidden Responses' and 'Acknowledging Correct Feedback' sections overlap significantly, and the 'Real Examples' section partially restates earlier content. The repeated emphasis on 'no thanks/no performative agreement' across multiple sections could be consolidated.

2 / 3

Actionability

Highly actionable with concrete examples of good vs bad responses, specific decision trees (source-specific handling, YAGNI checks), exact patterns to follow, and even a specific GitHub API command for thread replies. The pseudocode-style decision flows are appropriate for a behavioral/process skill rather than a code-generation skill.

3 / 3

Workflow Clarity

Clear multi-step sequences with explicit validation checkpoints: the main response pattern (READ→UNDERSTAND→VERIFY→EVALUATE→RESPOND→IMPLEMENT), the 'stop and clarify before implementing' feedback loop for unclear items, the implementation order with per-item testing and regression checks, and the external reviewer verification checklist all demonstrate strong workflow clarity with appropriate error recovery paths.

3 / 3

Progressive Disclosure

The content is well-organized with clear section headers and a logical flow from overview to specifics, but it's quite long for a single file with no references to supporting documents. The common mistakes table, real examples, and some of the repeated behavioral guidance could be split into a reference file to keep the main skill leaner.

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.