CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pr-description

Use when writing a pull request title or body, when about to run gh pr create, when about to git push on a branch that already has an open PR, or when the user says /pr-description, "write the PR description", or "update the PR title". Don't use for commit messages, changelogs, or review comments.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is pr-description in TanStack/ai

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 procedural skill: concrete commands, copy-ready templates, hard gates with stop conditions, and error-recovery guidance make it fully actionable with a clear validated workflow. The only notable gaps are mild token redundancy from repeated "post immediately" rules and a red-flags table that restates inline rules.

DimensionReasoningScore

Conciseness

The body is imperative and lean with no explanations of concepts Claude already knows; every gate, template, and command earns its place. Not 5: "Do not wait for the user to approve" is repeated in the intro, section 6, and the red flags table, and the red flags table restates several rules already given inline.

4 / 5

Actionability

Fully executable throughout: concrete commands ("git log --oneline base...HEAD", "gh pr list --limit 15 --state all --json title", "gh pr create --title \"...\" --body-file ...", "gh pr edit ...") plus copy-ready markdown templates for Root cause, Possible alternatives, and Public API change. Specific examples cover the common fix/feat/chore cases.

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints (the HARD-GATE: "If none of those exist, stop... Wait until they add one, then continue"), feedback loops for error recovery ("If `gh` fails, stop and show the error. Leave the drafted body in the chat"), fix-PR gating via bugfix-pr, and a red-flags self-correction checklist.

5 / 5

Progressive Disclosure

Single-file skill (no references/scripts/assets bundle exists) with well-organized sections, a classification table, and clearly signaled one-level-deep pointers to sibling skills (.claude/skills/simple-english/SKILL.md, i-have-adhd). Not 5: at ~200 lines, the long body-section spec and the partially duplicative red flags table could be trimmed or moved to a reference file.

4 / 5

Total

18

/

20

Passed

Description

90%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 with excellent trigger coverage, explicit when-to-use guidance, and explicit boundaries against adjacent skills. The only weakness is that the capability statement is thin — one action ("writing a pull request title or body") — while the richer behaviors (posting via gh, template handling, gates) live only in the body.

DimensionReasoningScore

Specificity

The only explicitly stated capability is "writing a pull request title or body" — a domain plus 1-2 concrete actions, matching anchor 3. Not 4: it does not list several specific actions (posting, template handling, and gating appear only in the body, not the description).

3 / 5

Completeness

Both "what" ("writing a pull request title or body") and "when" (multiple explicit triggers including tool invocations and quoted user phrases) are clearly answered. Not 4: the when-clause is highly specific with concrete trigger phrases, not merely adequate.

5 / 5

Trigger Term Quality

Natural user phrasing is comprehensively covered: "pull request title or body", "gh pr create", "git push", "/pr-description", "write the PR description", "update the PR title" — including synonyms (title/body/description) and the slash command. Nothing natural is missing for this domain.

5 / 5

Distinctiveness Conflict Risk

Clear PR-description niche with distinct triggers and explicit exclusions ("Don't use for commit messages, changelogs, or review comments") that prevent overlap with adjacent skills.

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

TanStack/ai

Path

.grok/skills/pr-description/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.