write-pr-description

Featured

Write or revise the pull request description in PR_AGENTDESC.md, as a forked agent that reads the branch itself. Fills the frontmatter properties, a Conventional Commits title, and every section the repository's template declares, then clears the mechanical validator before returning. The pr skill calls this to draft, fix-pr calls it after remediation commits arrive, and merge-pr calls it for a final pass. Every call pairs with review-pr-description afterwards.

AI & Automation 73 stars 6 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
62
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Write a pull request description Write `PR_AGENTDESC.md` at the repository root, then return. You run forked, so the branch diff sits in your context rather than the caller's. Read the material below and write from it. ## Arguments `$ARGUMENTS` carries the repository root, and after it whatever the caller wants addressed. A first draft arrives with nothing extra. A revision arrives carrying the findings `review-pr-description` returned, or a note that remediation added commits the description hasn't caught up with. Treat any findings in the arguments as the work. Resolve each one and say so. ## Context !`bash ${CLAUDE_SKILL_DIR}/scripts/context.sh` ## The shape Write the file in exactly this order. ```text --- base: <branch this merges into> draft: <true or false> labels: [<one or more from the set above>] reviewers: [] assignees: [] milestone: --- # <type>(<scope>)?: <description> ## <first template section> <prose> ``` Those frontmatter keys and no others. Labels take a flow sequence and an empty one fails the validator, because nobody's filter finds an unlabelled pull request. The title is a level 1 heading in the Conventional Commits shape. A squash merge turns it into the commit subject on the default branch, so its type has to be one the landing commits use, and it names what the whole branch does rather than what the last commit did. Then every section the template declares, in the template's order, filled with prose. Replace each instructional comment...

Details

Author
tbhb
Repository
tbhb/vale-ai-tells
Created
8 months ago
Last Updated
2 days ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

Code & Development Featured

review-pr-description

Review a drafted pull request description in PR_AGENTDESC.md against the branch it would publish, as an independent agent, for what mechanical checking can't see. Covers claims the diff doesn't support, counting, provenance filler, restating the diff, a title describing one commit rather than the branch, and whether the branch is one coherent change. The pr skill invokes this before opening every pull request, passing the repository root.

73 Updated 2 days ago
tbhb
AI & Automation Listed

create-pr-description

Author a comprehensive, reviewer-ready pull request or GitLab merge request description from the current branch's changes and the working session's context, saved to an isolated temp file. Use this whenever someone is wrapping up a piece of work and needs the writeup — phrasings like "write the PR description", "draft the PR/MR", "create a pull request description", "describe these changes for review", or finishing a branch before opening a merge request. The skill's edge is that it carries the reasoning the diff can't show — why this approach, the root cause behind a bug, the decisions and rejected alternatives, scope and follow-ups, related tickets, and how this PR fits a multi-PR effort.

1 Updated 1 months ago
FarzamMohammadi
AI & Automation Listed

pr

Write a pull-request title and description from the real branch diff. Use when the user asks for a PR, PR description, or to open a pull request.

1 Updated 4 weeks ago
2Tricky4u