CtrlK
BlogDocsLog inGet started
Tessl Logo

code-review-checklist

Comprehensive checklist for conducting thorough code reviews covering functionality, security, performance, and maintainability

43

Quality

30%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/code-review-checklist/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description identifies its domain (code reviews) and lists high-level coverage areas, but reads more like a document title than a skill description. It lacks concrete actions, explicit trigger guidance ('Use when...'), and natural keyword variations that would help Claude reliably select it from a large skill set.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to review code, check a pull request, or wants a code quality assessment.'

Replace the high-level category list with specific concrete actions, e.g., 'Checks for security vulnerabilities, identifies performance bottlenecks, flags error handling gaps, and verifies test coverage.'

Include natural trigger term variations like 'PR review', 'pull request', 'review my code', 'code quality check', 'code audit'.

DimensionReasoningScore

Specificity

Names the domain (code reviews) and lists categories (functionality, security, performance, maintainability), but doesn't describe concrete actions like 'check for SQL injection', 'verify error handling', or 'flag N+1 queries'. The categories are high-level rather than specific actions.

2 / 3

Completeness

Describes what it is (a checklist for code reviews) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'what' is also weak (it's a noun phrase describing a thing rather than actions), so this scores a 1.

1 / 3

Trigger Term Quality

Includes 'code review' which is a natural trigger term, and related terms like 'security', 'performance', 'maintainability'. However, it misses common variations like 'PR review', 'pull request', 'review checklist', 'code quality', or 'review my code'.

2 / 3

Distinctiveness Conflict Risk

The 'code review checklist' framing is somewhat specific, but could overlap with general coding skills, security audit skills, or code quality/linting skills. The broad categories (security, performance, maintainability) could trigger conflicts with more specialized skills in those areas.

2 / 3

Total

7

/

12

Passed

Implementation

27%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill is excessively verbose, repeating common code review knowledge that Claude already possesses. While the checklist format and code examples provide some actionable structure, the content is largely generic and could be condensed to roughly 20% of its current size. The monolithic structure with no progressive disclosure makes it a poor use of context window space.

Suggestions

Reduce content by 70-80%: Remove explanations of basic concepts (what SQL injection is, what edge cases are) and focus only on the specific checklist template and any project-specific conventions Claude wouldn't already know.

Split the detailed checklists (functionality, security, code quality, performance) into separate referenced files, keeping only a compact summary checklist in the main SKILL.md.

Add a clear workflow with decision points: when to approve, when to request changes, when to block—with explicit validation steps rather than just listing categories of things to review.

Remove the 'When to Use This Skill', 'Common Pitfalls', 'Best Practices', and 'Review Comment Templates' sections entirely—these are generic knowledge that Claude already has.

DimensionReasoningScore

Conciseness

Extremely verbose at ~350+ lines. Extensively explains concepts Claude already knows (what code review is, what edge cases are, what SQL injection is). The checklist items are largely common knowledge for Claude. The 'When to Use This Skill' section, 'How It Works' steps, 'Common Pitfalls', and 'Best Practices' sections are all padded with obvious information that wastes tokens.

1 / 3

Actionability

The checklists provide some concrete structure and the code examples (good/bad patterns) are executable and specific. However, much of the content is descriptive rather than instructive—it lists what to check but doesn't provide concrete commands, tools, or automated workflows Claude could execute. The checklist format is useful but largely generic.

2 / 3

Workflow Clarity

Steps are listed (Step 1-6) but they are essentially just categories of things to check, not a true workflow with validation checkpoints or feedback loops. There's no explicit guidance on what to do when issues are found, no prioritization of findings, and no clear decision points (e.g., when to block vs. approve with comments).

2 / 3

Progressive Disclosure

Monolithic wall of text with everything inline. The three detailed example checklists (functionality, security, code quality) could easily be separate files. External links at the bottom are to third-party resources rather than organized companion files. The 'Related Skills' section references skills that may not exist. No content is appropriately split into referenced files.

1 / 3

Total

6

/

12

Passed

Validation

90%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
sickn33/antigravity-awesome-skills
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.