CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-review

Use this skill when the user wants to review code, audit a pull request, check code quality, find bugs, or get feedback on implementation.

Quality

75%

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

Fix and improve this skill with Tessl

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

Quality

Content

76%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 highly actionable, executable skill body whose code, security checklist, and report template are copy-paste ready. Its main gaps are an unsequenced workflow (the process is implied by section order rather than explicit steps) and the absence of any validation checkpoint before submitting an outward-facing GitHub PR review, plus minor padding of code Claude could write unaided.

Suggestions

Add an explicit numbered review workflow (e.g., 1. Obtain the diff or file, 2. Run static analysis, 3. Apply the security checklist, 4. Verify each finding against the actual diff, 5. Produce the report from the template).

Add a validation step before the PR-review submission (e.g., 'Confirm every finding cites a real file:line from the diff before calling create_review').

Trim the git-diff wrapper functions, which Claude can write unaided, or move the AST complexity and PyGithub scripts into a references/ file to slim the main SKILL.md.

DimensionReasoningScore

Conciseness

The body is mostly lean — checklists, thresholds, and executable code with no concept tutorials — but a couple of blocks pad it with things Claude already knows: trivial git-diff wrappers ('get_staged_diff'/'get_pr_diff') and a bare pylint invocation add little beyond common knowledge. It clearly beats anchor 3 (unnecessary explanatory prose) but has minor trimmable code, matching anchor 4.

4 / 5

Actionability

Every code block is complete and copy-paste ready (diff retrieval, pylint with JSON parsing, AST complexity check with explicit thresholds, PyGithub review submission), the security checklist uses concrete checks with fixes ('Use parameterized queries', 'Validate with Path.resolve()'), and the report template and Quick Reference table give exact commands. This matches the fully-executable anchor 5.

5 / 5

Workflow Clarity

A sequence is only implicit in section order (get diff → run static analysis → apply security checklist → fill report template); no numbered workflow ties the pieces together, and there are no validation checkpoints — notably nothing says to verify findings against the diff before posting a PR review to GitHub (an outward-facing submit). This matches anchor 3: sequence present but checkpoints missing or implicit, and it cannot exceed 3 given the unvalidated PR-review submission step.

3 / 5

Progressive Disclosure

The file is well-sectioned with clear headers (Overview, Review Structure, Static Analysis, Security Checklist, PR Review, Template, Quick Reference) and everything is one level deep in a single self-contained SKILL.md with no buried references. It misses anchor 5 because at ~110 lines (above the sub-50-line simple-skill exception) self-contained tools like the AST complexity script and PyGithub snippet could reasonably live in reference files.

4 / 5

Total

16

/

20

Passed

Description

61%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 trigger-first description with strong, natural 'when' guidance but a weak 'what': it never states what the skill does (structured markdown review covering correctness, security, performance, plus static analysis integration), only the situations that call for it. Adding a third-person capability statement before the 'Use when' clause would lift both completeness and specificity.

Suggestions

Lead with a third-person statement of what the skill does, e.g. 'Performs structured code reviews of files, diffs, or GitHub PRs covering correctness, security, performance, and test coverage, producing a severity-ranked markdown report.', before the 'Use when' clause.

Add common trigger synonyms such as 'PR review', 'code audit', or 'review my diff' to broaden natural keyword coverage.

Mention the distinctive outputs (security checklist, static analysis integration) to further separate it from generic security-review or linting skills.

DimensionReasoningScore

Specificity

The description names the domain (code review) via the user-intent actions "review code, audit a pull request, check code quality, find bugs, or get feedback on implementation", but these are near-synonyms of a single action rather than a list of distinct capabilities; the skill's actual features (structured markdown reports, security checklist, static analysis, GitHub PR submission) are never stated, so coverage is not comprehensive. It is above anchor 2 ('Processes PDF files'-level genericness) because multiple concrete action phrases are present, but below anchor 4 because it does not list several specific capabilities with only minor gaps.

3 / 5

Completeness

The 'when' is explicit and strong ("Use this skill when the user wants to review code, audit a pull request..."), but the 'what' is only weakly implied — no third-person statement of what the skill actually does (structured review covering correctness, security, performance, producing a markdown report). It is better than anchor 2 ('Use when working with documents' with nothing else) because the reviewing action is named, but below anchor 4, which requires both an explicit 'what' and an explicit 'when'.

3 / 5

Trigger Term Quality

Phrases like "review code", "audit a pull request", "check code quality", "find bugs", and "get feedback on implementation" are natural things a user would say, giving good keyword coverage. A few common variations are missing (e.g., 'PR review', 'code audit', 'lint my code'), so it falls just short of the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Core triggers like "audit a pull request" and "find bugs" carve a fairly distinct niche with minimal conflict risk. There is minor overlap with closely related skills (e.g., a dedicated security-review or linting skill could also match 'check code quality' or 'find bugs'), which matches anchor 4 rather than the clearly-distinct anchor 5.

4 / 5

Total

14

/

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

ProwlrBot/prowlr-marketplace

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.