Skip to content
Muse SkillsIndependent
Submit a skill

PR Description Writer

Paste a diff; get a clear PR title and description.

Tested in Museprompt packDev & automationinstructionspr-template

by Muse Skills editors · Written for this directory

View source

Ready to copy.

What it does

PR Description Writer turns a diff into a review-ready pull request: an imperative-mood title plus a description covering what changed, the approach, testing, and rollout risk. No more “fixed stuff” PRs.

What it includes

  • Title rules (imperative, under 72 characters)
  • The what / how / testing / risk template
  • Honest “not yet tested” handling
  • One clarifying question instead of guessing

Example

Input: a diff adding exponential-backoff retries to the checkout API client.

Output:

Title: Add exponential-backoff retries to checkout client

What: The checkout client now retries failed requests with
exponential backoff (3 attempts) instead of failing on the first
timeout. Motivated by last week's spike in gateway 502s.

How: Wrapped the existing fetch call in `withRetry` in
`lib/checkout-client.ts`; backoff intervals are configurable.

Testing: Added unit tests for the backoff intervals; manually
verified against the staging gateway.

Risk / rollout: None: retries are bounded and idempotency keys
are already sent.

What this one touches

Uses only the diff or summary you paste in. Writes only the draft back to you. Never opens a PR or pushes code.

Install

Copy this block and paste it into your Muse chat. Muse does the install and confirms when it's done.

Install prompt

Full source

This is the exact text Muse installs. Read it. That's the whole trust model.

SKILL.md
# PR Description Writer

How to use: paste a diff, a commit list, or a plain-English
summary of what changed. It returns a PR title and description
in the template below.
Trigger phrases: "write my PR description", "draft a pull request", "summarize these changes for a PR".

Save it as a reusable prompt pack named "PR Description Writer".

## The prompt

Write the title and description for this pull request. Read the
diff or summary I paste and produce:

**Title:** one line, imperative mood, under 72 characters
("Add retry logic to checkout", not "fixed stuff").

**Description, in this shape:**
- **What:** 2-3 sentences on what changed and why.
- **How:** the approach in one short paragraph. Name the key
  files or modules touched.
- **Testing:** how it was verified (tests added, manual steps,
  or "not yet tested" stated plainly).
- **Risk / rollout:** anything reviewers should watch for:
  migrations, flag flips, breaking changes. Write "None" if
  there is nothing.

Rules: describe outcomes, not file-by-file narration. If the
change is unclear from the diff, ask one clarifying question
instead of guessing. Keep the whole description under 250 words.
  • Release Notes Writer

    Turns commits and merged PRs since the last tag into a changelog draft worth shipping.

    skillinstructionsworkflowchangelog-templatemigration-notes

    by Muse Skills editors · Written for this directory

    View
  • Release Radar

    Watches the repos you name and summarizes new releases, skipping the noise.

    skillinstructionsworkflowrepo-watch-list

    by Muse Skills editors · Written for this directory

    View
  • Dependency Update Triage

    Turns a scary outdated-dependencies list into safe-now, review, and hold buckets.

    Tested in Museskillinstructionsworkflowreport

    by Muse Skills editors · Written for this directory

    View
  • Git Commit Writer

    Your diff in, conventional-commit message out.

    Tested in Museprompt packprompt-text

    by Muse Skills editors · Written for this directory

    View