commits-and-prs
Skill4 starsChanged 57 days agoApache-2.0View on GitHub
Write commit messages and pull request descriptions for this repository. Use when committing, opening a pull request, or asked to write a PR body, release note, or changelog entry.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- Zejnilovic/agdtheir own version, first seen Nov 1, 2026
- manuelLandreau/claude-skillstheir own version, first seen Oct 11, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- Zejnilovic/agd★ 5same name
- manuelLandreau/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository14 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- decomposeSkill
- github-boardSkill
- implementSkill
- releaseSkill
- reviewSkill
- reviseSkill
- rubber-duckSkill
- specifySkill
- thunderstormSkill
- triageSkill
- worktreeSkill
- writing-docsSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 6 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Write for the person reading git log in a year with no memory of this work.
- Very specific: line 12
Use the writing-docs skill for the prose.
- Distinctive: line 66
Every commit here is authored by the repository owner.
- Distinctive: line 70
Leave the trailers a harness writes exactly as it wrote them, and add none by hand.
- Distinctive: line 113
Do not restate the diff. Do not recount the path you took to the change: the dead ends, the thing you tried first, the file you read.
- Distinctive: line 130
No status tables, no progress checklists, no restating the plan.
- Very specific: line 135
Add to ## Unreleased in CHANGELOG.md under Added, Changed, Fixed, or Removed.
- Distinctive: line 151
Write a pull request body with headings.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Commits and pull requests
Write for the person reading git log in a year with no memory of this work.
They are skimming for one change among hundreds. Every line you add is a line
they read before they find it.
Use the writing-docs skill for the prose. Everything here is in addition to
it.
Length
The pull request title and body become the squash commit, verbatim. This
repository merges with squash_merge_commit_title=PR_TITLE and
squash_merge_commit_message=PR_BODY, so there is one text to get right and
one place to get it right: the pull request. A branch's own commit messages are
discarded at merge and are checked for shape alone.
| Text | Target | Where the number comes from |
| Pull request title | 53 characters | 59 allowed, less the (#NN) |
| Pull request body | 20 lines | It is the commit body |
| Pull request comment | 100 words | A reply, not a report |
| Review comment | 200 words | Ten findings; see review |
| Edit reply | 150 words | Ten outcomes; see revise |
The body is a commit body, so wrap it at 72 columns and use no headings:
## What reaches git log as the literal characters ## What. One shape, at
one size.
Comments are counted in words because GitHub soft-wraps them. A 40-line comment
there is 400 words, which is how the old line targets were met and missed at
once. writing-docs carries that rule for everything else.
.claude/scripts/check-commit-message.py --pr --title-file <f> --body-file <f>
reports the title and the body, and CI runs it on every edit to either.
Commit messages
<type>: <what changed, imperative, lowercase, under 60 characters>
<why it changed, wrapped at 72 characters>Types used here: feat, fix, docs, refactor, test, chore, perf.
.claude/scripts/check-commit-message.py checks the shape: the type, the
60-character subject, the blank line, and the 72-column body. Fenced blocks,
trailers, and unbreakable strings such as URLs are exempt from the column limit.
It runs in two places. Enable the hook locally once with
git config core.hooksPath .githooks, and it rejects a branch message while
that message is still in the editor. CI runs the same script in --pr mode
over the title and body, which is the text that lands, and reports without
failing: both stay editable until the merge, so naming a problem is worth more
than blocking on it.
Length is reported and rejected by neither, under Length.
Authorship
Every commit here is authored by the repository owner. Agents work under their direction, and which one typed a given commit was never checkable, so the log does not try to say.
Leave the trailers a harness writes exactly as it wrote them, and add none by hand. Name no model in a subject or a body. The message describes the change, not what produced it.
Review comments carry a model tag. The first line names the model and reasoning
level the pass ran at, under the review skill, because which reviewer found a
defect is a question a reader of the thread asks.
Pull request bodies
A reviewer wants to know what to look at and whether it works. Say that, and
stop. The body is scaffolding for one review; it is not a record, because it
never reaches git log.
Most changes need only this:
Closes #<issue>
One paragraph: what changed, and what behavior it produces.
Verified with `<command>`: <result>.
Not covered: <what was left, with a link>.There is no second, longer form. A body with headings reaches git log with
its ## characters intact, and four headings over a six-line body is a form
rather than a description: a reviewer reads the headings, finds a sentence
under each, and learns less than the one paragraph would have told them. A
change too large to describe in twenty lines wants a document in internal/
and a link to it.
Requirements:
Verifiednames actual commands and actual results. "Tests pass" without the command is not verification. If a check was not run, say so.Not coveredis required and may not be empty. WriteNothingonly when you have looked for gaps and found none. One line is a complete answer.- Any test that was changed, removed, or narrowed gets a line explaining why.
- Twenty lines, wrapped at 72 columns. It is the commit body, and the reader
is skimming
git logfor one change among hundreds.
Do not restate the diff. Do not recount the path you took to the change: the dead ends, the thing you tried first, the file you read. A reviewer is deciding about the code in front of them.
Pull request comments
A comment is a reply in a conversation. A hundred words is already long for one, and GitHub soft-wraps, so count words rather than lines.
The harness appends its own footer. That is the harness's line, not a signature; add none of your own.
- Answer the question that was asked. Do not summarize the change again.
- One comment per review pass, not one per finding. The
reviewskill sets what a pass posts. - Say what you changed and where.
Fixed in <sha>beats a paragraph. - Skip the acknowledgement-only comment. Resolving the thread says it.
- No status tables, no progress checklists, no restating the plan. If a reviewer needs the state of the branch, CI is the state of the branch.
Changelog
Add to ## Unreleased in CHANGELOG.md under Added, Changed, Fixed, or
Removed. Write for a user of thndrs, not for a contributor: name the
behavior that changed, not the module that changed.
Skip the changelog for internal refactors, test-only changes, and documentation that does not describe a behavior change.
Do not
- Pad a body to look thorough. Length reads as effort and costs the reader.
- Narrate the work: what you tried first, what you read, what you ruled out. The result is the deliverable.
- Restate in the pull request what the commits already say, or in a comment what the pull request already says.
- Claim a check ran when it did not.
- Sign a commit body as a model, or name one in it.
- Write a pull request body with headings. It is the commit message.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

