CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-review-web

Review web application code for bugs, security issues, performance problems, and stack-specific anti-patterns. Use this skill whenever the user wants to review code, debug a production issue, investigate a build failure, audit security, or check a PR before merging. Triggers on code review, review my code, debug, build error, broken, not working, why is X failing, check this code, security check, PR review, audit code, refactor. Also triggers when investigating 4xx or 5xx errors, deploy failures, environment variable issues, and CMS integration problems.

Quality

85%

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

The canonical home for this skill is code-review-web in rampstackco/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

71%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-structured review skill with excellent progressive disclosure and a clear, concrete checklist-driven body. Its main cost is token efficiency — sizable chunks of the five-dimensions framework are generic code-review knowledge Claude already has — and the primary review workflow lacks a verification step before output.

Suggestions

Cut the Maintainability and generic-Correctness dimensions down to only web/stack-relevant checks, or move the full generic checklist into a reference file — the naming/comments/complexity/magic-number guidance is knowledge Claude already has and costs context on every load.

Add an explicit verification checkpoint to the main review workflow (e.g., "Pull the branch and run the code before writing findings" — the body already states this in Failure patterns, but it is not part of the workflow sequence).

Make the higher-level steps concrete with commands or examples: how to check function/build logs, how to force a cache invalidation, and a one-line example of a severity-tagged finding so the output format is unambiguous.

DimensionReasoningScore

Conciseness

The writing style is terse and unpadded, but a substantial portion of the content restates knowledge Claude already has rather than adding skill-specific value: the Maintainability section ("Functions do one thing", "Comments. Explain why, not what", "No literal `60000` in code. Use named constants") and parts of Correctness ("Edge cases handled (empty states, error states, network failures)", "Off-by-one errors, null/undefined handling") are textbook code-review knowledge. This fits the 3 anchor ("includes some unnecessary explanation or could be tightened") better than 4, since the generic material is more than a minor instance; it is clearly above 2 because nothing is verbose and the web-specific material (bug patterns, debugging workflow) genuinely earns its tokens.

3 / 5

Actionability

Most checks are concrete and executable as instruction-only guidance: specific attributes ("Session cookies have `Secure`, `HttpOnly`, `SameSite` attributes"), specific failure modes ("Adding a NOT NULL column without populating it for existing rows"), and concrete commands ("`git log --oneline`"). It stops short of the 5 anchor because much of the guidance is check-descriptions rather than runnable commands or examples — e.g., "Force a cache invalidation" and "Check hosting build and function logs" name what to do but not how, and there is no example of the expected review output inline.

4 / 5

Workflow Clarity

Both workflows are clearly sequenced: the 6-step review workflow and the 9-step debugging workflow, the latter with explicit checkpoints ("Reproduce locally. Confirms it's a code issue and not an environment issue", "Verify in production. Check the actual fix worked, not just that the deploy succeeded"). It is not a 5 because the main review workflow lacks an equivalent verification checkpoint (no step to run the code, run tests, or confirm findings before writing the review), and the "Failure patterns" self-check list is not tied into the workflow as an explicit loop.

4 / 5

Progressive Disclosure

The split is exactly right: stack-agnostic patterns stay in SKILL.md while stack-specific detail lives in three one-level-deep references ("Stack-specific patterns for Next.js (App Router, ISR, Server Components..."), headless WordPress patterns, and the review template), all linked inline and again in a dedicated "Reference files" section with descriptions. All three referenced files exist in the bundle, and navigation is easy; the unreferenced `_claude-frontmatter-extras.yaml` in references/ is a port artifact, not content, so it doesn't impair navigation.

5 / 5

Total

16

/

20

Passed

Description

91%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 explicit what and when clauses, comprehensive natural trigger terms, and appropriately web-scoped capabilities. The only weaknesses are minor: it under-sells its output artifacts and its generic triggers could overlap with non-web review skills.

DimensionReasoningScore

Specificity

The description lists several concrete review actions — "Review web application code for bugs, security issues, performance problems, and stack-specific anti-patterns" — each a distinct capability within the code-review domain. It falls just below the 5 anchor because it omits output-side actions the skill actually performs (e.g., producing a formal markdown review document or postmortem), a minor gap in coverage.

4 / 5

Completeness

It explicitly answers both questions: the "what" ("Review web application code for bugs, security issues, performance problems, and stack-specific anti-patterns") and the "when" ("Use this skill whenever the user wants to review code, debug a production issue, investigate a build failure, audit security, or check a PR before merging") with concrete trigger phrases. This matches the 5 anchor's example structure directly; it is above the 4 anchor because the when-clause is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

Trigger coverage is comprehensive and natural: "code review, review my code, debug, build error, broken, not working, why is X failing, check this code, security check, PR review, audit code, refactor" plus "4xx or 5xx errors, deploy failures, environment variable issues, and CMS integration problems". These are the exact phrases a user would say, including synonyms and symptom-level language; nothing common is missing for this domain.

5 / 5

Distinctiveness Conflict Risk

The scope is narrowed to "web application code" with web-specific triggers (CMS integrations, deploy failures, 4xx/5xx), giving it a mostly distinct niche. It sits at 4 rather than 5 because broadly shared triggers like "debug", "refactor", and "review my code" would also fire for non-web code-review skills, and the description itself does not disambiguate against closely related skills (performance deep-dives, QA testing) — that disambiguation only exists in the body's "When NOT to use" section.

4 / 5

Total

18

/

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

rampstackco/claude-skills

Path

dist/codex/.agents/skills/code-review-web/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.