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
58%
Does it follow best practices?
Impact
97%
1.34xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/receiving-code-review/SKILL.mdQuality
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...').
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
6fd4507
Table of Contents
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.