CtrlK
BlogDocsLog inGet started
Tessl Logo

pr-explainer

Use when creating an approachable, self-contained HTML review aid for a pull request; explaining what changed, why it matters, how it works, and how it fits into the broader system; turning PR diffs, commits, tests, and architecture context into a local `.pr-review/` HTML page for reviewers; or helping reviewers understand complex code changes without dumping the full diff.

69

Quality

85%

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

81%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-crafted skill body: concrete git commands, a clear sequenced workflow with an explicit final checklist, and disciplined imperative phrasing that avoids over-explaining. It is a single-file skill with no bundle references, which is acceptable but leaves the HTML/CSS scaffolding to be reinvented per run.

DimensionReasoningScore

Conciseness

The body is lean and imperative throughout — "Inspect the current state with `git status --short`", "Do not commit `.pr-review/` by default" — with no explanations of concepts Claude already knows. Minor tightening is possible (the 'Verification requirements' and 'Final checklist' sections partially repeat points already made), which keeps it just below the every-token-earns-its-place anchor.

4 / 5

Actionability

Concrete, executable commands are given (`git log --oneline -n 10`, `git diff <base>...HEAD --stat`, `pnpm --filter @scope/package test ...`) plus a copy-paste HTML snippet pattern for focused diffs. Minor gaps remain — the diff HTML is a pattern rather than a complete page template, and some commands use inherent placeholders — so it fits 'mostly executable with minor gaps' better than the fully copy-paste-ready top anchor.

4 / 5

Workflow Clarity

The 4-step required workflow (understand → find explanation path → write → create file) is clearly sequenced with conditional handling ("If one commit carries the main change..."), and the 'Final checklist' provides an explicit pre-completion validation step, with a fallback directive ("If verification was not run, say so clearly"). This matches the top anchor's clear sequence plus explicit checkpoints/checklists; score 4 would lack the checklist-style validation present here.

5 / 5

Progressive Disclosure

The skill is a single well-organized SKILL.md with no bundle files (references/, scripts/, assets/ absent) and no external references; sections are clearly headed (workflow, HTML structure, diagrams, snippets, verification, checklist) and the body contains no dangling file references. At ~145 lines it exceeds the under-50-line threshold that would allow a score of 5 on organization alone, and some material (e.g., the full recommended HTML structure with CSS conventions) could arguably live in a reference file, so 'good structure, minor organization gaps' is the best fit.

4 / 5

Total

17

/

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: it explicitly answers both what and when, uses third-person/trigger phrasing consistent with best-practice examples, and names concrete artifacts (`.pr-review/` HTML page, diffs, commits, tests). The only weaknesses are a handful of missing natural trigger synonyms and modest overlap risk with general PR-review skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions: "creating an approachable, self-contained HTML review aid", "explaining what changed, why it matters, how it works, and how it fits into the broader system", and "turning PR diffs, commits, tests, and architecture context into a local `.pr-review/` HTML page". This matches the comprehensive-coverage anchor (multiple specific concrete actions) and exceeds the score-4 anchor, which allows for coverage gaps.

5 / 5

Completeness

It opens with an explicit trigger clause ("Use when creating... for a pull request") and clearly states what the skill produces (a self-contained local `.pr-review/` HTML page explaining what changed, why, how, and system fit). Both what and when are explicitly and concretely answered, matching the top anchor; score 4 would require the 'when' to be less specific than it is here.

5 / 5

Trigger Term Quality

Natural trigger terms are present: "pull request", "PR diffs", "commits", "tests", "review", and ".pr-review/" — phrases a user would plausibly say. A few common variations are missing (e.g., "explain this PR", "PR walkthrough", "summarize this diff"), so it sits at good-but-not-comprehensive keyword coverage rather than the score-5 synonym-complete anchor.

4 / 5

Distinctiveness Conflict Risk

The niche is clear — a local HTML review-explainer page in `.pr-review/` — with distinct triggers around diffs, commits, and reviewer comprehension. However, it overlaps moderately with general PR-review skills (e.g., 'review a GitHub pull request' phrasing could pull in a code-review skill instead), so it is mostly distinct with minor overlap risk rather than minimal.

4 / 5

Total

18

/

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
mastra-ai/mastra
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.