CtrlK
BlogDocsLog inGet started
Tessl Logo

write-pr-description

Writes the body of a pull request - the summary, the repository template sections, and reviewer guidance such as a recommended reading order and focus areas. Use whenever drafting or revising a PR description, filling in a repository's PR template, refreshing a description that no longer matches the branch, or preparing a branch for review. Use it even when the user only says "open a PR", "put this up for review", or "write this up" without naming the description.

78

Quality

98%

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

100%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 tightly written, highly actionable instruction-only skill: a six-step workflow with embedded verification and a recovery-oriented self-check, executable git/gh commands, concrete output shapes, and clean progressive disclosure into two well-signaled reference files that exist and deliver what the links promise. No dimension shows more than trivial room for improvement.

DimensionReasoningScore

Conciseness

The body never explains what Claude already knows (no 'what a PR is', no tool tutorials — it explicitly instructs the opposite: "Explain this change, not the reviewer's tools"), and nearly every sentence states a rule, a concrete example, or an exemption ("Record decisions with their rejected alternatives. This is the highest-value content in most descriptions and it cannot be recovered from the diff"). It assumes competence ("Skip it when a competent reviewer will know where to look") and dedicates an entire step to cutting. This matches the 5 anchor (lean, every token earns its place) rather than the 4, where instances of over-explanation could be trimmed — I could not find any sentence whose only job is padding.

5 / 5

Actionability

Guidance is concrete and executable throughout: copy-paste-ready commands ("git --no-pager log <base>..HEAD", "gh pr view <n> --repo <owner/repo> --json title,commits,files,baseRefName", "gcloud iam roles describe"), a default body shape with exact headings ("## Review guide", "## What changed", "## Validation"), word-count anchors per change size, and quoted example phrasings for the validation section ("Expect one destroy and one create, nothing else"). Per the code_vs_instruction note, an instruction-only skill with this density of specific guidance warrants 5 rather than 4.

5 / 5

Workflow Clarity

A clear numbered sequence (1 collect facts → 2 follow template → 3 write body → 4 reviewer guidance → 5 cut → 6 self-check) with verification built into the workflow (step 1: "Do not forward a claim you have not checked" with a list of specific cheap checks) and a closing self-check checklist that includes an error-recovery loop ("Did the cut take a decision...? ...Put them back"). This matches the 5 anchor (explicit validation steps, feedback loops, checklist); no gaps keep it at 4.

5 / 5

Progressive Disclosure

The bundle structure is clean: two reference files (references/plain-language.md, references/review-guide.md), both real, both one level deep, both linked exactly at their point of use with their content signaled ("See references/plain-language.md for the rules and the exemptions"; "See references/review-guide.md, which opens with a short map of which of its sections you need" — verified true: that file opens with a 'Which part of this file you need' section). The bulky material (plain-language rules, review-guide details) is split out rather than inlined, and the body keeps only the decisions. This is the 5 anchor (clear overview, well-signaled one-level-deep references), not the 4.

5 / 5

Total

20

/

20

Passed

Description

96%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.

An excellent description: concrete, third-person, comprehensive action coverage, with both an explicit what and an explicit when, including colloquial trigger phrasings. Its only weakness is intentional overlap on generic PR-related requests, which is a minor conflict risk with a sibling PR-mechanics skill.

DimensionReasoningScore

Specificity

"Writes the body of a pull request - the summary, the repository template sections, and reviewer guidance such as a recommended reading order and focus areas" names multiple concrete, domain-specific actions spanning the whole task (summary, template sections, reading order, focus areas). It is comprehensive rather than having minor gaps, so it matches the 5 anchor, not the 4 ('several specific actions; minor gaps in coverage'); third-person voice is used correctly.

5 / 5

Completeness

It explicitly answers both questions: what ("Writes the body of a pull request - the summary, the repository template sections, and reviewer guidance...") and when ("Use whenever drafting or revising a PR description, filling in a repository's PR template... Use it even when the user only says 'open a PR'..."). Both are concrete and explicit, matching the 5 anchor rather than the 4 ('when' could be more explicit).

5 / 5

Trigger Term Quality

The description covers natural phrasings comprehensively, including indirect user asks users actually say: "drafting or revising a PR description", "filling in a repository's PR template", "refreshing a description that no longer matches the branch", "preparing a branch for review", plus the quoted colloquial triggers "open a PR", "put this up for review", and "write this up". This is the 5 anchor (comprehensive synonyms and variations); the 4 anchor's 'a few natural terms missing' does not fit.

5 / 5

Distinctiveness Conflict Risk

The niche is clear and well-bounded ("Writes the body of a pull request" vs. the mechanics of opening one, with the body text explicitly deferring to `create-pr`), so it is well above the 3 anchor. However, the deliberate trigger "Use it even when the user only says 'open a PR', 'put this up for review', or 'write this up' without naming the description" claims requests that could equally invoke a PR-creation or review skill, which is a minor overlap risk with closely related skills — the 4 anchor, not the 5 ('minimal conflict risk').

4 / 5

Total

19

/

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
warpdotdev/common-skills
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.