CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-reviewer

Code review automation for TypeScript, JavaScript, Python, Go, Swift, Kotlin, C#, .NET, Java, C, C++, Rust, Ruby, PHP, and Dart/Flutter. Analyzes PRs for complexity and risk, checks code quality for SOLID violations and code smells, generates review reports. Use when reviewing pull requests, analyzing code quality, identifying issues, generating review checklists.

70

Quality

88%

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-reviewer in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

90%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 SKILL.md body: token-efficient tables and executable commands instead of prose, a crisp extension-dispatch loading model, and an extension workflow with a real regression-guard validation step. The main gaps are the implicit ordering of the three tools into a single review pipeline and bundle references (rules/, languages/, scripts/, assets/) that could not be verified to exist in the provided directory.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence throughout: thresholds and verdicts are compact tables, tool usage is shown purely as annotated bash commands with flags, and there is zero explanation of concepts Claude already knows (no "what a PR is", no library tutorials). Every section — dispatch table, loading order, thresholds, regression fixtures — earns its tokens. It clearly matches the 5 anchor rather than the 4, which reserves room for trimmable over-explanation that is absent here.

5 / 5

Actionability

Guidance is fully executable and copy-paste ready: "python scripts/pr_analyzer.py /path/to/repo --json", "python scripts/code_quality_checker.py . --language java" with the valid language values enumerated, "python scripts/review_report_generator.py . --format markdown --output review.md", and a concrete diff-against-expected-outputs regression command. Specific numeric thresholds (>50 lines, >5 params) and a verdict table cover the common cases, matching the 5 anchor.

5 / 5

Workflow Clarity

The loading order is an explicit numbered sequence (SKILL.md → rules/universal.md → matching language file), and the "Adding a New Language" workflow is a numbered 1–6 sequence ending in a validation checkpoint ("commit the expected --json output under expected_outputs/ as a regression guard", with a diff-based drift check shown). It falls short of 5 because the end-to-end review pipeline — when to run pr_analyzer vs. code_quality_checker vs. review_report_generator, and in what order — is only implied by the report generator's --pr-analysis/--quality-analysis flags rather than sequenced explicitly; it stays above 3 because checkpoints (regression fixtures, expected-output diffs) are genuinely present.

4 / 5

Progressive Disclosure

The written structure is exemplary: a dispatch table maps extensions to exactly one language file, the loading order is pinned to "always exactly 2 additional files", and references (rules/universal.md, languages/*.md) are one level deep and clearly signaled. However, the referenced bundle files (rules/, languages/, scripts/, assets/, expected_outputs/) are not present in the skill directory as provided, so the references could not be verified as real files — a risk of broken navigation that keeps this at 4 rather than 5.

4 / 5

Total

18

/

20

Passed

Description

83%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: concrete third-person capabilities, an explicit 'Use when...' trigger clause with natural phrases, and a clearly defined multi-language code-review niche. The only meaningful gap is slightly generic action framing ("complexity and risk") and a few missing natural trigger variations like "review my code" or "PR review".

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Analyzes PRs for complexity and risk, checks code quality for SOLID violations and code smells, generates review reports" — with specific targets like SOLID violations and code smells. It falls just below a 5 because the actions are limited to three and "analyzes complexity and risk" is comparatively generic; coverage of what the tooling actually does is good but not comprehensive (e.g., no mention of the language-specific rules or security signals).

4 / 5

Completeness

Both questions are explicitly answered: the 'what' is concrete ("Analyzes PRs for complexity and risk, checks code quality for SOLID violations and code smells, generates review reports") and the 'when' is an explicit trigger clause ("Use when reviewing pull requests, analyzing code quality, identifying issues, generating review checklists") with concrete trigger phrases. It clearly matches the 5 anchor rather than the 4, whose 'when' clause is present but less specific.

5 / 5

Trigger Term Quality

Natural user phrases are present: "reviewing pull requests", "analyzing code quality", "identifying issues", "generating review checklists", plus terms like PRs, SOLID, and code smells. It falls short of a 5 because common variations users would actually say — "review my code", "PR review", "code review" as a standalone trigger phrase, "refactor" — are missing; it stays above 3 because keyword coverage is solid and includes multiple natural phrasings, not just technical jargon.

4 / 5

Distinctiveness Conflict Risk

The description carves a fairly clear niche (multi-language PR review automation with named checks like SOLID violations and code smells) with distinct triggers. It is not a 5 because "code review" and "code quality" are broad, high-traffic categories where overlap with other review-oriented skills is plausible; it is well above 3 because the specific trigger set (pull requests, review checklists, SOLID) is distinctive.

4 / 5

Total

17

/

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

referenced_paths_exist

Referenced path issues: 13 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/code-reviewer/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.