CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

review-pr

Assess a FastMCP pull request for justified behavior, compatibility, and correctness, then follow CI and review feedback to a revision-specific verdict. Use for draft or ready PRs and self-review before publication.

Quality

83%

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

73%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 rigorous, well-sequenced review procedure with explicit validation checkpoints, error-recovery loops, exact GitHub commands, and a concrete verdict template. Its main weakness is conciseness: dense, heavily qualified prose with policy repeated across steps 3 and 6, plus specialized merge/attribution sub-procedures inlined rather than split into reference files.

Suggestions

Consolidate the maintainer-repair policy, which currently appears in both step 3 ('make the localized repair within authorization rather than submitting a changes-requested review') and step 6 ('maintainer repairs should be localized finishing touches...'), into a single statement to remove redundancy and tighten the prose.

Break the long multi-clause sentences in steps 1 and 3 (e.g., the single-paragraph scope instructions and the maintainer-escalation paragraph) into short imperative bullets so each instruction is scannable.

Move the squash-merge attribution procedure and the contributor-credit checklist out of the GitHub evidence section into a dedicated reference file (or files), keeping SKILL.md as a pointer to them.

DimensionReasoningScore

Conciseness

The body contains no padding about concepts Claude already knows, but it is written in long, heavily qualified multi-clause sentences (e.g., the single-paragraph step 1 and step 3's three sub-paragraphs) and repeats policy — the maintainer-repair/localized-fix guidance appears in both step 3 ('make the localized repair within authorization rather than submitting a changes-requested review') and step 6 ('maintainer repairs should be localized finishing touches...'). Not 2 because nearly every sentence carries decision-relevant review policy rather than filler; not 4 because the prose could be tightened substantially without losing substance.

3 / 5

Actionability

Concrete, copy-paste-ready commands are provided ('gh pr view <number> --repo PrefectHQ/fastmcp --json baseRefOid,headRefOid,title,body,statusCheckRollup,reviews,comments,isDraft,labels', 'gh pr merge <number> --squash --body-file /tmp/merge-body.md --match-head-commit <reviewed-head>') along with a fill-in verdict template. Not 5 because several directions remain abstract without specifics, such as 'Check API ergonomics, docs, and whether dependency minimums support newly used APIs' and 'inspect failed CI logs' with no log-fetching command.

4 / 5

Workflow Clarity

The seven-step procedure is clearly sequenced (scope, want-decision, contract, cause/compatibility, independent verification, feedback resolution, revision-specific verdict) with explicit validation checkpoints: run the regression on unchanged base and proposed head, confirm CI actually ran on the current head, inspect failed CI logs before diagnosing, re-check title/body/labels/head/checks/branch protections immediately before an authorized merge, and a final 'Check before finishing' gate. Error-recovery feedback loops are present (fix real defects together, verify adjacent behavior, repeat the adversarial pass after substantive rework, reproduce supposedly unrelated failures on the base).

5 / 5

Progressive Disclosure

Sections are well organized (Procedure, GitHub evidence, Verdict template, Check before finishing) and references are one level deep and clearly signaled ([review-issue](../review-issue/SKILL.md), [python-tests](../python-tests/SKILL.md), the contributing.mdx anchors). Not 5 because specialized sub-procedures — the squash-merge attribution workflow and the contributor-credit checklist — are inlined in the GitHub evidence section and would fit better in a separate reference file, and no bundle files exist to offload them.

4 / 5

Total

16

/

20

Passed

Description

87%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: it states concrete review actions, includes an explicit 'Use for...' trigger clause covering draft/ready PRs and pre-publication self-review, and pins itself to the FastMCP domain. The only weakness is that its action phrasing ('assess for justified behavior, compatibility, and correctness') stays at a moderately abstract level rather than enumerating the concrete review operations.

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Assess a FastMCP pull request for justified behavior, compatibility, and correctness', 'follow CI and review feedback to a revision-specific verdict' — with only minor gaps (e.g., what self-review before publication concretely involves). It falls below the comprehensive 5 anchor because the actions remain somewhat abstracted rather than enumerating the full set of review operations.

4 / 5

Completeness

It explicitly answers both what ('Assess a FastMCP pull request for justified behavior, compatibility, and correctness, then follow CI and review feedback to a revision-specific verdict') and when ('Use for draft or ready PRs and self-review before publication') with concrete trigger phrases. Not 4 because the when-clause is explicit and specific, not merely implied or generic.

5 / 5

Trigger Term Quality

Natural user terms are present: 'FastMCP', 'pull request', 'PRs', 'CI', 'self-review', 'draft', 'review feedback'. A few natural phrases users would say are missing, such as 'code review', 'approve', or 'merge readiness', keeping it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The FastMCP-specific niche ('Assess a FastMCP pull request...') gives it a clear domain with distinct triggers and minimal conflict risk against generic code-review or CI skills. Not 4 because the technology name and PR-review framing leave virtually no ambiguity about when this skill applies.

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

relative_links

Relative link issues: 6 suspicious

Warning

Total

15

/

16

Passed

Repository

PrefectHQ/fastmcp

Path

.agents/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.