describing-prs

name	describing-prs
description	Generate a PR description for the current branch. Writes Markdown to .git/magit/posts/new-pullreq for use with magit-forge.
allowed-tools	Bash(~/.agents/skills/describing-prs/scripts/find-merge-base.py:*)

PR Description Generator

Generate a well-structured PR description for the current feature branch.

When to Use This Skill

Use this skill when:

• Preparing to create a pull request
• Needing a PR description for the current branch
• Integrating with magit-forge for PR creation

Process

1. Determine the base branch

   Run the helper script to find the base branch:

   BASE=$(~/.agents/skills/describing-prs/scripts/find-merge-base.py)
   

   The script outputs a branch name (e.g., origin/main) that represents the base branch for comparison. It handles cases where you branched from another feature branch, not just main/master.

   Options:

   • --fetch: Fetch latest remote refs before determining base branch
   • --debug: Show how the base branch is determined

   Strategy (implemented in the script):

   • Try @{upstream} first (the current branch's configured upstream)
   • Try origin/HEAD (the remote's default branch)
   • Fall back to common defaults: origin/main, origin/master,