CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-pr

Review a pull request against CDP architecture standards — fetches PR diff, verifies previous comments are addressed, validates PR metadata (title, branch, issue reference, size), runs a code-standards enforcer against every file in `.claude/rules/` and `.claude/hooks/guard-protected-files.sh`, and drafts inline review comments with suggested fixes. NEVER auto-posts comments or submits reviews — always presents a draft in the terminal for user approval before any comment lands on the PR. Use when reviewing PRs, checking PR quality, validating code changes, or when the user says "review", "check this PR", or "audit code".

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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, highly actionable skill: every phase gives executable commands and templates, the workflow has explicit validation checkpoints including a mandatory user-approval gate before posting, and the bundle's four checklists are real and one level deep. Minor improvements available: de-duplicate the PR-size rule, signal the reference checklists more prominently in the body, and consider moving the enforcer-agent prompt details to a reference file.

DimensionReasoningScore

Conciseness

The body is dense with project-specific, non-redundant knowledge (exact gh/git commands, severity calibration, regexes) and assumes Claude's competence, but has minor trimmable fat: the PR size rule appears in both Phase 4 and again in "Additional Rules", and the full enforcer-agent prompt (severity calibration, checklist paths) is inlined where a reference file could carry it. This matches level 4 (efficient with minor instances that could be tightened), not the fully lean level 5.

4 / 5

Actionability

Fully executable throughout: copy-paste-ready commands (gh pr view/diff, git merge-base --is-ancestor, grep -oE extraction), a defined JSON output contract for the subagent, exact AskUserQuestion options, and concrete table templates — covering the common cases per the level-5 anchor.

5 / 5

Workflow Clarity

Six phases are clearly sequenced with parallelization instructions ("Run all of the following in a single turn"), an explicit wait for the background enforcer in Phase 5, a false-positive verification filter, and — critically for an outward-facing operation — a hard approval checkpoint with "Do NOT proceed until the user explicitly picks an option" and "Treat silence or ambiguous replies as 'don't post'", matching the level-5 anchor's explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

The four domain checklists referenced in the body all exist in the bundle (references/backend-checklist.md, frontend-checklist.md, services-checklist.md, sql-checklist.md) and are one level deep with no nested references, and phase headers make the overview navigable. However, the checklist references are surfaced only inside the enforcer-agent prompt as raw paths rather than clearly signaled links in the body, and some inline content (severity calibration, detailed metadata checks) could live in reference files — good structure with minor organization gaps, i.e. level 4 rather than the well-signaled level 5.

4 / 5

Total

18

/

20

Passed

Description

88%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: specific, third-person, comprehensive on capabilities, and equipped with an explicit 'Use when' clause containing natural trigger phrasings. The only weaknesses are a couple of missing trigger synonyms and slight generic-trigger overlap risk with general code-review skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "fetches PR diff", "verifies previous comments are addressed", "validates PR metadata (title, branch, issue reference, size)", "runs a code-standards enforcer", "drafts inline review comments with suggested fixes" — comprehensively covering the skill's capabilities in third-person voice, matching the level-5 anchor rather than level 4 whose coverage has minor gaps.

5 / 5

Completeness

It explicitly answers both questions: a detailed 'what' (five enumerated capabilities plus the NEVER-auto-posts constraint) and a concrete 'when' ("Use when reviewing PRs, checking PR quality, validating code changes, or when the user says 'review', 'check this PR', or 'audit code'"), matching the level-5 anchor exactly.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases users would say — "reviewing PRs", "checking PR quality", "validating code changes", and quoted utterances "review", "check this PR", "audit code". A few natural variants are missing (e.g. "code review", "look at this PR"), so it sits at level 4 rather than the comprehensive synonym coverage of level 5, but well above the partial coverage of level 3.

4 / 5

Distinctiveness Conflict Risk

The CDP-specific scope ("against CDP architecture standards", ".claude/rules/", "guard-protected-files.sh") gives it a clear niche, but the bare trigger "review" and generic "validating code changes" could overlap with a general code-review skill in the same environment — minor overlap risk consistent with level 4, not the minimal-conflict level 5.

4 / 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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

linuxfoundation/crowd.dev

Path

.claude/skills/review-pr/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.