Code review practices emphasizing technical rigor, evidence-based claims, and verification. Use when receiving code review feedback, completing tasks requiring review, or before making completion claims.
81
76%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/code-review/SKILL.mdQuality
Discovery
67%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 has good completeness with explicit 'Use when' triggers, but lacks specificity in describing concrete review actions. The trigger terms cover the basics but miss common user phrasings like 'PR' or 'pull request'. The scope of 'completing tasks requiring review' is somewhat broad and could cause conflicts with other skills.
Suggestions
Add specific concrete actions like 'validates error handling, checks test coverage, identifies security issues, reviews code style consistency'
Expand trigger terms to include common variations: 'PR review', 'pull request', 'review my code', 'check my changes', 'code feedback'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (code review) and mentions some concepts (technical rigor, evidence-based claims, verification), but lacks concrete actions like 'check for null handling', 'verify test coverage', or 'validate error handling'. | 2 / 3 |
Completeness | Clearly answers both what (code review practices emphasizing technical rigor, evidence-based claims, verification) and when (receiving code review feedback, completing tasks requiring review, before making completion claims) with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes 'code review' and 'review feedback' which are natural terms, but misses common variations like 'PR review', 'pull request', 'review my code', 'check my changes', or 'code feedback'. | 2 / 3 |
Distinctiveness Conflict Risk | The code review focus provides some distinction, but 'completing tasks requiring review' and 'before making completion claims' are broad enough to potentially overlap with general coding or task completion skills. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill that efficiently communicates code review practices with good progressive disclosure. The decision tree format is particularly effective for quick reference. The main weakness is the lack of concrete, executable examples - the CI Verification section would benefit from actual commands rather than abstract instructions.
Suggestions
Add specific CI command examples in the CI Verification section (e.g., `npm run ci`, `make check`, or project-specific commands)
Include a concrete example of what 'stating claim WITH evidence' looks like in practice (e.g., showing terminal output or test results)
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, using bullet points and a decision tree to convey information without unnecessary explanation. No concepts are over-explained; Claude's competence is assumed throughout. | 3 / 3 |
Actionability | Provides clear guidance on when to use each practice and a useful decision tree, but lacks concrete executable examples. The CI Verification section mentions running checks but doesn't provide specific commands or code snippets. | 2 / 3 |
Workflow Clarity | The decision tree provides clear sequencing for different situations. The verification gates section establishes explicit checkpoints (run CI, verify passes, don't proceed if fails). The workflow is unambiguous for each scenario. | 3 / 3 |
Progressive Disclosure | Excellent structure with a concise overview and clear one-level-deep references to detailed protocols in the references folder. Navigation is well-signaled with descriptive links for each detailed topic. | 3 / 3 |
Total | 11 / 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.
3376255
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.