CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-pr

Use when writing or editing a pull-request title and body in this repository — at prep-pr Step 8, when a later commit or a review makes the body untrue, or for any pull request that closes public issues or private tracker findings. Covers the title, the six sections and what each holds — the change's impact first — the Closes and Part of lines and what a public body may say about a tracker issue, owner and deploy actions, an honest test plan, the faults agent-written bodies fall into, and the command that opens or edits it.

74

Quality

93%

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

92%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 dense, highly actionable process document: every step is executable, validation checkpoints and feedback loops are built into the workflow, and the one reference file is real, early, and one level deep. The only notable criticism is length — minor rhetorical framing and some cross-section repetition could be trimmed without losing any rule.

DimensionReasoningScore

Conciseness

Extremely dense with repo-specific rules and no explanations of concepts Claude already knows, but at ~300 lines there are trimmable spots: the three-readers framing paragraph, and the tracker-fix "present effect only" rule repeated across Impact, Summary, and the Step 6 checklist — efficient with minor over-elaboration, matching anchor 4 rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Fully executable throughout: the exact skeleton block, worked title examples, per-section templates (owner-action lead-ins, the four-field decision format, the test-plan table), and copy-paste commands including the gh REST open call with flags explained, the full GraphQL closing-issues query, and grep/awk verification pipelines — matching the copy-paste-ready anchor.

5 / 5

Workflow Clarity

A clear six-step sequence with explicit validation and feedback loops: the pre-send checklist of grep commands, the closes-registration loop ("If one is missing... fix the file, PATCH it, check again"), and the merged/closed state check that halts before any edit — matching the anchor requiring explicit validation, error-recovery loops, and checklists.

5 / 5

Progressive Disclosure

The single bundle file, references/examples.md, exists, is referenced early and clearly signaled ("A worked body, before and after, is in references/examples.md"), and is exactly one level deep with no buried or nested references; the body is cleanly sectioned and the bulky worked example is appropriately offloaded — matching the clear-overview anchor.

5 / 5

Total

19

/

20

Passed

Description

92%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 strongly specific, third-person description that explicitly answers both what it covers and when to use it, with repo-distinct triggers that separate it from adjacent skills like prep-pr and write-issue. Its only weakness is trigger-term breadth: it lacks the "PR" abbreviation and other synonyms a user might naturally say.

DimensionReasoningScore

Specificity

Enumerates multiple concrete deliverables — "the title, the six sections", "the Closes and Part of lines", "owner and deploy actions, an honest test plan, the faults agent-written bodies fall into, and the command that opens or edits it" — comprehensively covering what the skill body actually teaches, matching the comprehensive-coverage anchor rather than anchor 4's minor-gaps profile.

5 / 5

Completeness

Opens with an explicit "Use when" clause carrying three concrete triggers ("at prep-pr Step 8, when a later commit or a review makes the body untrue, or for any pull request that closes public issues or private tracker findings") and follows with an explicit what via "Covers the title, the six sections and what each holds" — both halves answered explicitly with trigger phrases.

5 / 5

Trigger Term Quality

Good natural-keyword coverage ("writing or editing a pull-request title and body", "closes public issues", "test plan", "deploy actions"), but the abbreviation "PR" — the term a user is most likely to say — never appears, and no synonyms beyond "pull-request" are given, so it falls short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche (PR title and body prose in this repository) with distinct triggers including the "prep-pr Step 8" handoff and "private tracker findings", which explicitly draws the boundary against the one closely related skill — minimal conflict risk.

5 / 5

Total

19

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

englishstreetventures/osn

Path

.claude/skills/write-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.