pr-description-writer

npx skills add Varnan-Tech/opendirectory --skill pr-description-writer --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# PR Description Writer Read the current branch diff and write a complete GitHub pull request description. Create or update the PR with one command. ## Writing Style Apply to all generated PR descriptions: - Active voice. "Adds X" not "X has been added." - Present tense for summary ("Adds caching layer"), past tense for context ("The old approach caused N requests per render") - Short sentences, one idea per bullet - No em dashes — use a comma or period instead - No filler: "this PR", "this commit", "as per the discussion" - Specifics beat generalities: "reduces p95 latency from 800ms to 90ms" beats "improves performance" --- ## Step 1: Check Setup Confirm `gh` is authenticated: ```bash gh auth status ``` If not authenticated: `gh auth login` and follow the prompts. Confirm the current directory is a git repo with an active branch: ```bash git branch --show-current ``` If detached HEAD or no branch, stop and ask the user which branch they want to describe. --- ## Step 2: Gather Diff Context Run all three commands to build context: **File summary (what changed):** ```bash git diff main...HEAD --stat ``` **Commit messages (why it changed):** ```bash git log main...HEAD --oneline ```

gh auth status
git branch --show-current
git diff main...HEAD --stat
git log main...HEAD --oneline
if git rev-parse origin/main &>/dev/null 2>&1; then
elif git rev-parse main &>/dev/null 2>&1; then
else
fi
git diff $BASE...HEAD
gh pr view --json title,body,baseRefName 2>/dev/null