create-pr

Solid

Generate a short, narrative GitHub pull request description (≤ 25 lines, hard ceiling 40), push the branch, open the PR as a draft, then run the review-loop skill for a bounded review-apply-simplify convergence before finalizing. The review-loop (pr-reviewer → implement-suggestion → polish simplify, up to 5 iterations, converging until every review thread is resolved via fix or reply) runs AFTER the draft PR is open — the single reviewer now operates on PRs. Scale down with --no-review (skip the pr-reviewer pass), --no-simplify (skip simplify), --quick (light mechanical pass only), or --no-quality (skip the loop entirely). A post-push external-bot feedback loop also runs by default (--no-feedback to skip), scoped to external bots only so it does not re-apply the review-loop's own findings. With --split, analyses the branch diff and breaks it into 2–4 focused, dependency-ordered draft PRs after user approval. Escalates judgment-required CI failures via /confidence rather than guessing. Invoke with /create-pr,

Code & Development 8 stars 2 forks Updated 2 days ago MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
32
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Generate Pull Request Description Generate a **short, narrative** PR description that tells reviewers *why* this change exists and *what* to expect when they open the diff. Reviewers skim. If the description is long, they skip it. Respect their time. ## Modes Parse `$ARGUMENTS`. `--split` selects an alternate workflow. The post-draft quality step (Step 6.5) runs the **full review + simplify loop by default**; the `--no-*` / `--quick` flags below **scale it down**. All flags compose with the default and split workflows. | Mode / Flag | Trigger | Behaviour | | -------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `default` | No flag | One PR for the whole branch. After opening the draft PR (Step 6), Step 6.5 runs `Skill("review-loop")` — up to 5 iterations of `pr-reviewer` → `implement-suggestion` → `polish simplify`, converging until every review thread is resolved (fix or reply) and refreshing the PR description. | | `split` | `--split`, `-s`, or first positional token `split` | Analyse the branch diff, propose 2–4 depe...

Details

Author
mthines
Repository
mthines/agent-skills
Created
3 months ago
Last Updated
2 days ago
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

write-pr-description

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.

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

create-pr

Generates a PR description template — title, summary, tasks, and notes (with an optional diagram for flow-shaped changes). Use when the user asks to write a PR description, create a PR template, or prepare a pull request write-up. Does NOT push code or create a real PR on GitHub.

7 Updated today
minhtran3124