CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-review-and-quality

Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another agent, or a human. Use when you need to assess code quality across multiple dimensions before it enters the main branch. Use when asked to review a diff or a pull request, even when the diff is pasted inline.

Quality

79%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/code-review-and-quality/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 skill delivers a well-sequenced, genuinely actionable review workflow with explicit validation steps and severity labeling — its strongest qualities. Its weaknesses are length and repetition (the same principles are restated across four-plus sections, including basics Claude already knows) and a monolithic structure whose only external references point to files that do not exist in the bundle.

Suggestions

Move the Dependency Discipline upgrade workflow, Common Rationalizations table, and Red Flags list into a reference file (e.g., references/review-heuristics.md) and link them from the body, trimming the main SKILL.md substantially.

Fix or remove the broken 'See Also' paths ('../../references/security-checklist.md', '../../references/performance-checklist.md') — they point outside the skill directory and no such files exist in the bundle; either ship them as proper one-level-deep bundle references or drop the section.

Deduplicate recurring principles (refactor-relocates-complexity, one-dependency-per-change) by stating each once and cross-referencing, and cut universal checks like parameterized SQL and XSS encoding that Claude already applies by default.

DimensionReasoningScore

Conciseness

The body is dense and opinionated rather than padded, but at ~400 lines it repeats the same guidance in multiple sections: the 'refactor relocates complexity' idea appears in Architecture, Structural Remedies, Common Rationalizations, Red Flags, and Verification, and 'one dependency per change' likewise recurs four times. It also spends tokens on checks Claude already knows (parameterized SQL, XSS output encoding), fitting 'mostly efficient but could be tightened' (3) rather than the more severely padded level 2.

3 / 5

Actionability

For an instruction-only skill, the guidance is concrete and executable: a severity-label table, a copy-paste dead-code report template, an example review-agent prompt, and a runnable mutation-check procedure ('Invert one condition the change adds (drop a negation, swap && for ||), run the suite, then restore the file from a copy'). Not 5 because the five-axis bullets remain judgment-level checklists rather than fully worked examples of findings.

4 / 5

Workflow Clarity

A clear five-step review process is explicitly sequenced with validation checkpoints: review tests first with a mutation experiment, check findings against callers/guards/tests before reporting, verify the author's verification story, and a final verification checklist with escalation rules. This matches the 5 anchor (explicit validation steps, feedback loops, checklists); this is a review skill, not a destructive/batch operation, so no cap applies.

5 / 5

Progressive Disclosure

The body has clear section headers, but no bundle files exist (no references/, scripts/, or assets/), and the 'See Also' section points to '../../references/security-checklist.md' and '../../references/performance-checklist.md' — paths outside the skill directory with no corresponding files in the bundle. Substantial content that belongs in separate reference files (the dependency-upgrade workflow, Common Rationalizations table, Red Flags) is inlined in an already ~400-line SKILL.md, fitting 'some structure but could be better organized; references present but not clearly signaled' (3).

3 / 5

Total

15

/

20

Passed

Description

78%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 in third-person voice with explicit, concrete 'Use when...' triggers covering both self-authored and externally-authored code, inline diffs, and pre-merge gating. Its main weakness is specificity: it says 'multi-axis review' without enumerating the concrete review activities, which limits a user's ability to predict what the skill actually does.

Suggestions

Enumerate one or two concrete capabilities in the description (e.g., 'Labels findings by severity and distinguishes regressions from pre-existing defects') so a reader can predict what the review produces, not just that one happens.

Add a common trigger variant such as 'Use when asked whether a change is ready to merge' to broaden natural-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ('multi-axis code review', 'assess code quality across multiple dimensions') but these restate a single action rather than listing several distinct concrete capabilities such as severity-labeling findings or categorizing regressions vs. pre-existing defects. It fits 'names domain and 1-2 concrete actions' (3) better than 'lists several specific actions' (4), since those activities only appear in the body.

3 / 5

Completeness

It explicitly answers both what ('Conducts multi-axis code review', 'assess code quality across multiple dimensions before it enters the main branch') and when, via multiple concrete 'Use when...' clauses. This matches the 5 anchor (both answered with concrete trigger phrases) rather than 4, whose 'when' is less explicit.

5 / 5

Trigger Term Quality

Phrases like 'reviewing code written by yourself, another agent, or a human', 'review a diff or a pull request, even when the diff is pasted inline', and 'before merging any change' are natural user phrasings with good coverage. Not 5 because common variants like 'review my changes', 'is this ready to merge', or 'check this code' are not covered.

4 / 5

Distinctiveness Conflict Risk

The code-review niche is clear with distinct triggers (diff/PR review, pre-merge gate), so it mostly matches 'mostly distinct; minor overlap risk' (4). Not 5 because it could overlap with closely related skills like dedicated security-review or code-simplification skills.

4 / 5

Total

16

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

addyosmani/agent-skills

Path

skills/code-review-and-quality/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.