CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-github-pr

Review a GitHub pull request by summarizing its diff and key design decisions. Use when the user wants to review a PR, understand changes in a branch, or get a code review summary. Trigger keywords - review PR, review pull request, summarize PR, summarize diff, code review, review branch, PR summary, diff summary.

Quality

88%

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 step has executable commands, and edge cases (branch-only reviews, failed lookups, huge diffs, multiple matching PRs) are handled with explicit fallback and recovery paths. The only meaningful improvements are trimming the redundant commands/examples sections and moving the lengthy crypto/agent-infra policy into one-level-deep reference files.

DimensionReasoningScore

Conciseness

The body is efficient: concrete commands with terse bullets, no explanations of concepts Claude already knows (it never explains what a PR or git diff is), and the dense sections (issue acceptance, concern formatting, crypto/agent-infra policy) convey repo-specific rules Claude could not infer. Minor trim opportunities exist — the 'Useful Commands Reference' table and 'Example Usage' section largely restate commands and steps already fully specified in Steps 1–4 — which fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the lean score-5 anchor.

4 / 5

Actionability

Guidance is fully executable throughout: copy-paste-ready commands for every step ('gh pr list --head "<branch>" --state open', 'gh pr view <number> --json title,body,...', 'gh pr diff <number>', 'git fetch origin main <branch>' / 'git diff origin/main...origin/<branch>', 'gh api repos/OWNER/REPO/collaborators/AUTHOR/permission --jq .permission'), a concrete output template, and worked examples covering the two common input cases (PR number, branch name).

5 / 5

Workflow Clarity

Steps 1–5 are clearly sequenced with explicit validation and error-recovery branches: ambiguous input (multiple PRs → ask the user), PR-resolution outcomes (one / many / none), command failure ('gh pr diff' fails → local git diff fallback; branch-only → diff against main), oversized diffs (chunk via the Task tool, merge summaries), and failed issue lookups ('Report failed lookups as unverified and continue the code review'). This matches the anchor requiring explicit validation steps and feedback loops; the operation is read-only, so the destructive-operation cap does not apply.

5 / 5

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist, and the single file is well organized into clearly signaled sections (Prerequisites, Steps 1–5, commands table, examples) with no nested-reference chains — good structure with most content appropriately placed inline. It falls short of the score-5 anchor because the self-contained 200-line body includes sizable specialized policy (crypto boundaries, agent-infra consistency) that could live in one-level-deep reference files, and the one external link ('../../../crates/openshell-crypto/CRYPTO.md') plus the named 'sync-agent-infra maintenance map' point outside the skill bundle without bundled copies.

4 / 5

Total

18

/

20

Passed

Description

86%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 that clearly and explicitly states what the skill does and when to use it, backed by a comprehensive set of natural trigger phrases. Its only weaknesses are modest capability coverage (two actions named) and slight overlap risk from generic keywords like 'code review'.

DimensionReasoningScore

Specificity

The description names the domain ('Review a GitHub pull request') with two concrete actions ('summarizing its diff and key design decisions'), matching the anchor for domain plus 1-2 concrete actions but not comprehensive — it omits capabilities the skill actually has, such as branch-only diff reviews and flagging potential concerns. It falls below the score-4 anchor because it does not list several specific actions with only minor gaps.

3 / 5

Completeness

It clearly answers both 'what' ('Review a GitHub pull request by summarizing its diff and key design decisions') and 'when' ('Use when the user wants to review a PR, understand changes in a branch, or get a code review summary') with concrete trigger phrases, matching the score-5 anchor exactly. Neither component is vague or merely implied.

5 / 5

Trigger Term Quality

The trigger list ('review PR, review pull request, summarize PR, summarize diff, code review, review branch, PR summary, diff summary') comprehensively covers natural terms and their synonyms — users would genuinely say these phrases when they need this skill. File extensions are not applicable to this domain, so nothing meaningful is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is distinct — GitHub PR review with PR/branch/diff-specific triggers — but the generic keyword 'code review' and 'summarize diff' carry minor overlap risk with general code-review or diff-analysis skills. This fits 'mostly distinct; minor overlap risk with closely related skills' rather than the score-5 anchor, which requires minimal conflict risk.

4 / 5

Total

17

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

relative_links

Relative link issues: 1 missing, 1 suspicious

Warning

Total

13

/

16

Passed

Repository

NVIDIA/OpenShell

Path

.agents/skills/review-github-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.