CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

Quality

74%

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 ./.claude/skills/receiving-code-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 a minimal generated stub whose entire substance is a single redirect to a shared skill at an absolute home-directory path. As a token-efficient pointer it is exemplary, but judged on what is written, it provides no task guidance, no workflow, and its one reference is external to the bundle and unverifiable (the target file does not exist in this environment).

Suggestions

Inline a concise version of the core guidance (how to verify feedback, when to push back) or bundle the shared skill as a reference file inside the skill directory so the redirect target actually ships with the skill.

Replace the absolute path `~/.agents/skills/receiving-code-review/SKILL.md` with a bundle-relative reference (e.g. `references/process.md`) so the file resolves wherever the skill is installed.

Add a one-line overview of what the shared skill covers before the redirect, so the body is self-describing even if the external load fails.

DimensionReasoningScore

Conciseness

The body is two lines — a generator comment ("Generated by scripts/agent-harnesses.py; do not edit directly.") and one instruction — with zero padding and nothing explained that Claude already knows, matching anchor 5's 'lean and efficient; every token earns its place'. It cannot exceed 5, and it is not a 4 because there is no over-explanation to trim at all.

5 / 5

Actionability

The single instruction "Load and follow the shared skill at ~/.agents/skills/receiving-code-review/SKILL.md" is concrete (exact action, exact path), but all task-level guidance is deferred to an external file that is not part of the bundle and does not resolve in this environment — 'concrete but incomplete, missing key details' per anchor 3. Not 4 because the gap is not minor: the body contains no executable guidance for the skill's actual task; not 2 because the redirect itself is a fully specified step, not a high-level hint.

3 / 5

Workflow Clarity

The one written action is unambiguous (simple-skill treatment), but the body contains no workflow for the actual task of evaluating review feedback — no sequence, no verification checkpoints, nothing to assess — matching anchor 3's 'sequence present but checkpoints missing or implicit'. Not 4-5 because evaluation/validation steps exist nowhere in the evaluated body; not 2 because the single redirect step is precisely defined rather than 'poorly defined'.

3 / 5

Progressive Disclosure

The redirect is one clearly stated, one-level-deep reference (good shape), but the body has no overview content or sections, and the reference points to an absolute path outside the skill bundle (`~/.agents/...`) that does not exist here, leaving nothing navigable within the skill itself — anchor 3's 'some structure, could be better organized'. Not 4 because a well-organized bundle with appropriately placed content is absent; not 2 because nothing is inlined or buried.

3 / 5

Total

14

/

20

Passed

Description

73%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.

A strong description with an unusually explicit and well-conditioned 'Use when...' trigger clause and a clear anti-pattern statement that sharpens the skill's intent. The main weakness is the 'what' side: it prescribes a mindset ("technical rigor and verification") rather than naming the concrete actions the skill performs. Trigger coverage is good but misses common synonyms like "review comments" or "PR feedback".

Suggestions

Replace the abstract 'requires technical rigor and verification' with 2-3 concrete actions, e.g. 'verifies each suggestion against the codebase, reproduces claimed bugs, and pushes back with evidence when feedback is wrong'.

Add natural trigger synonyms such as 'review comments' or 'PR feedback' alongside 'code review feedback' to broaden when-clause matching.

Trim the tail clause ('not performative agreement or blind implementation') or fold it into the action list — it is framing rather than trigger content.

DimensionReasoningScore

Specificity

The description names the domain and a few action-ish phrases ("receiving code review feedback", "implementing suggestions", "verification"), matching anchor 3's 'domain plus 1-2 concrete actions, not comprehensive'. It is not a 4 because "requires technical rigor and verification" is an abstract disposition rather than a list of several specific actions (no 'verify claims against the code', 'reproduce the reported bug', etc.).

3 / 5

Completeness

Both parts are present: an explicit when-clause ("Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable") and a what-statement ("requires technical rigor and verification, not performative agreement or blind implementation"). It falls short of anchor 5 because the 'what' side is a behavioral requirement rather than concrete capabilities with concrete trigger phrases, matching anchor 4's 'both present, one could be more explicit/specific'.

4 / 5

Trigger Term Quality

Natural phrases users would say are present — "code review feedback", "implementing suggestions", "feedback seems unclear or technically questionable" — giving good coverage per anchor 4. Not 5 because common synonyms and variants ("review comments", "PR feedback", "address the reviewer's comments") are missing.

4 / 5

Distinctiveness Conflict Risk

The niche is clearly carved: "receiving code review feedback, before implementing suggestions" pins the receiving side of code review (not giving reviews, not writing commits), giving distinct triggers with minimal conflict risk per anchor 5. It does not drop to 4 because no closely related skill's triggers ('user asks Claude to review code') would plausibly match the receiving-oriented phrasing.

5 / 5

Total

16

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.claude/skills/receiving-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.