pr-writing SKILL.md skillA

pr-writing from timharris707/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add timharris707/skills/pr-writing@git:20261008.0b04f1c

Pins git:20261008.0b04f1c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
timharris707/skills
Path
plugins/clickai-codex/skills/run/pr-writing/SKILL.md
Versions recorded
2
Latest version
git:20261008.0b04f1c, committed Oct 8, 2026
First version recorded
Oct 7, 2026
Size
11,593 bytes
Repository stars
44
License
MIT

When filing a PR, updating a PR description, responding to PR review feedback, or writing a PR or review-thread comment on someone's behalf, lead with the problem, show before-and-after evidence that ran, and say whether a revert undoes the change.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# PR writing

Read the [Codex desktop binding](../../../CODEX.md) when this workflow needs harness mechanics, model routing, or recovery.

A PR is read by the decider and by reviewers long before anyone reads it in git history; and in a repo run through this pack, the decider may be a non-engineer whose merge decision rests entirely on the description. These rules bind every session writing a PR or comment on the decider's behalf, not just lanes the pack machinery launched. Most rules here exist because their violation shipped; the rest come from reviewed prior art named in Attribution. The examples are real agent-filed PRs from consuming repos, identifiers removed and content lightly paraphrased.

## Before filing

- Check whether a PR for this branch already exists; update it rather than filing a twin.
- Review the actual diff against the PR's base branch before writing anything: the description describes what the diff does, not what the lane meant to do, and a diff that doesn't match the driving item's goal is a finding to report, not to describe around.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add timharris707/skills/pr-writing@sha256:40326fed31b51ed3

The line at the top of this page pins the label git:20261008.0b04f1c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mrvbmongx66atfq4.svg)](https://markdownregistry.com/a/art_mrvbmongx66atfq4)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Oct 7, 2026 and Oct 8, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261008.0b04f1c latest2026-10-08 0b04f1c 11,593 BA view · diff
git:20261007.dc92fa82026-10-07 dc92fa8 11,530 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (11593 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

timharris707/skills · 44 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mrvbmongx66atfq4
GET https://markdownregistry.com/api/v1/resolve?ref=timharris707/skills/pr-writing
GET https://markdownregistry.com/api/v1/blob/40326fed31b51ed3223eb730da509dbf13d523c0e1c25cefc0656c4ee585f90b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from timharris707/skills

CLAUDE.md CLAUDE.md file
timharris707/skills · CLAUDE.md
git:20260906.c7e0ad4 · audit A · 44 stars
ingest SKILL.md skill
timharris707/skills · editions/codex/overrides/skills/investigate/ingest/SKILL.md · For a media file or URL shared with a goal, transcription requests, or takeaways from a call, demo, playtest, or video…
git:20260906.a9317e0 · audit A · 44 stars
huh SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/huh/SKILL.md · When a message did not land or pasted agent output needs translation, restate it plainly, expand shorthand, separate…
git:20260906.a9317e0 · audit A · 44 stars
plainspoken SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/plainspoken/SKILL.md · For chat replies, status updates, review comments, and commit messages, write plainly without AI tells. Also use to…
git:20260906.a9317e0 · audit A · 44 stars
writing-for-agents SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/writing-for-agents/SKILL.md · For skills, standing agent instructions, recorded rules, or documents agents skip, write and prune reliable triggers…
git:20261008.0b04f1c · audit A · 44 stars
writing-for-humans SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/author/writing-for-humans/SKILL.md · For public-facing drafts, pages that read like agent documentation, or a final AI-tell scrub, write clear human copy in…
git:20260906.a9317e0 · audit A · 44 stars
advisory-board SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/decide/advisory-board/SKILL.md · For an explicitly requested advisory board, roundtable, panel, idea tournament, multi-model review or debate, red-team…
git:20260906.a9317e0 · audit B · 44 stars
decision-map SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/decide/decision-map/SKILL.md · When asked to chart a decision map, work a map ticket, or plan work whose open decisions gate each other, map the…
git:20261009.3cdacee · audit A · 44 stars
grilling SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/decide/grilling/SKILL.md · When asked to grill, stress-test, or pressure-test an idea, or before a decision map or spec rests on an untested…
git:20261008.0b04f1c · audit A · 44 stars
codebase-review SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/codebase-review/SKILL.md · Before an upcoming feature, when merged work crosses the recorded review threshold, or when implementation exposes…
git:20261008.0b04f1c · audit A · 44 stars
ingest SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/ingest/SKILL.md · For a media file or URL shared with a goal, transcription requests, or takeaways from a call, demo, playtest, or video…
git:20260906.a9317e0 · audit A · 44 stars
prototype SKILL.md skill
timharris707/skills · plugins/clickai-codex/skills/investigate/prototype/SKILL.md · When discussion or static mockups cannot settle how something should look, behave, or feel, build a disposable…
git:20260906.a9317e0 · audit A · 44 stars

Every file in timharris707/skills

Other files named pr-writing

pr-writing SKILL.md skill
skyf0xx/hedgehog · src/skills/pr-writing/SKILL.md · Use whenever writing a PR title/description, a commit message body, a code review comment, or an issue — in Hedgehog's…
git:20260909.980f36c · audit A · 46 stars
pr-writing SKILL.md skill
timharris707/skills · skills/run/pr-writing/SKILL.md · Write a pull request the decider can judge from its description alone: problem first, before-and-after evidence, a…
git:20261008.0b04f1c · audit A · 44 stars
pr-writing SKILL.md skill
dkstm95/hope · plugins/hope/skills/pr-writing/SKILL.md · Write or update PR and MR titles and descriptions when creating or editing a pull request or merge request, including…
git:20260930.19be338 · audit A · 8 stars
pr-writing SKILL.md skill
tjcages/skills · pr-writing/skills/pr-writing/SKILL.md · Write or review clear commit messages, PR titles, and PR descriptions that explain what changed and why. Use before…
v1.0.0 · audit A · 6 stars

Browse by kind, by grade A, or by owner.