CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-review

Review a specific implementation, change set, PR, function, or service for broad correctness and production-readiness findings. Use when code-quality is the primary concern. Do not use when security, performance, architecture, dependencies, or tests are the exclusive requested discipline.

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-engineered review skill: lean expert-level guidance, a fully specified workflow with verification checkpoints, and a concrete output contract. The one real defect is that 10 of the 17 referenced files (all the shared/ policies and the workflow contract) are missing from the bundle, weakening its progressive-disclosure structure.

Suggestions

Ship the referenced shared/base/*.md policy files and shared/workflow-contract.md in the bundle, or inline/remove those links — ten of seventeen referenced paths are currently dead, which undermines the otherwise excellent reference structure.

Trim the Base Framework section (policy ID list and precedence ladder) and compress the Optional Workflow Integration section — both add ceremonial tokens without review guidance.

Consider moving the 'Example (abbreviated)' walkthrough into a reference file to keep the SKILL.md body focused on principles, workflow, and output contract.

DimensionReasoningScore

Conciseness

The body is dense with craft judgment Claude does not already have ("False positives are the cardinal sin", severity-honesty rules, diff-specific bug patterns) and avoids explaining basics, so most tokens earn their place. Not a 5 because the Base Framework section (policy-ID lists, precedence ordering) and the Optional Workflow Integration section carry noticeable ceremonial overhead that could be trimmed without losing guidance.

4 / 5

Actionability

For an instruction-only skill the guidance is fully executable: an 8-phase ordered workflow with per-phase scope, a concrete severity table with examples, a copy-paste output-format template, a worked (compressed) example, and PR-mode rules with explicit Approve/Request-changes recommendations. Anti-drift check: the 4-anchor ("minor gaps") does not fit — the output contract and per-phase heuristics are complete enough to execute directly.

5 / 5

Workflow Clarity

Phases are explicitly ordered ("Work the phases in order — context before judgment, correctness before polish") with validation checkpoints built in: verify-before-report, CRITICAL/HIGH findings must be individually traced, untraceable claims downgrade to questions, missing context triggers batched questions or stated assumptions, and empty sections must state what was checked. This matches the top anchor's sequence + validation + error-recovery loop.

5 / 5

Progressive Disclosure

Good structure: a reference-map table (Read | When), seven one-level-deep reference files that all exist in references/, and per-phase instructions to load them only when relevant. Not a 5 because ten referenced paths — the nine shared/base/*.md policy modules and shared/workflow-contract.md — do not exist in the bundle, leaving a substantial set of dead links that break the otherwise clean navigation.

4 / 5

Total

18

/

20

Passed

Description

87%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: third-person, concise, concrete about targets and deliverables, with explicit positive and negative trigger guidance that cleanly disambiguates it from specialist review skills. Only minor headroom in action specificity and trigger synonym coverage.

DimensionReasoningScore

Specificity

Names concrete review targets ("implementation, change set, PR, function, or service") and a concrete deliverable ("broad correctness and production-readiness findings"), going beyond the 1–2 action anchor, though it does not enumerate the finding categories (bugs, security, performance) it covers. Not a 5 because it describes one composite action — review — rather than multiple distinct concrete actions.

4 / 5

Completeness

Explicitly answers both questions: what ("Review a specific implementation... for broad correctness and production-readiness findings") and when ("Use when code-quality is the primary concern"), plus a negative trigger clause ("Do not use when security, performance, architecture, dependencies, or tests are the exclusive requested discipline"). This matches the top anchor: both what and when with concrete trigger phrasing.

5 / 5

Trigger Term Quality

Natural trigger terms are well covered: "review", "PR", "change set", "implementation", "correctness", "production-readiness", "code-quality" — phrases a user would plausibly say. A few natural variants ("code review" as a phrase, "is this ready to ship", "LGTM check") are absent, keeping it just below the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

The do-not-use clause explicitly carves out adjacent skills (security, performance, architecture, dependencies, tests), creating a clear niche with minimal conflict risk. The "primary concern" framing precisely separates broad code-quality review from specialist audits.

5 / 5

Total

18

/

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

relative_links

Relative link issues: 10 missing, 9 deeper-than-1-level

Warning

Total

15

/

16

Passed

Repository

Noorkhalel/saas-ai-skills

Path

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