Pull request description writer from the branch diff (English / Japanese)
Reads base...HEAD and the commits, groups changed areas, flags migrations, config, dependency and public API risks, lists test changes, and drafts a PR description in English or Japanese.
What it does
Writes a pull request description from what the branch actually changes.
- The bundled script reads
git diff base...HEADandgit log, and groups changed files by area with line counts - Risk hints: database migrations, dependencies, config and infrastructure, CI, public API, auth code, deleted files, changes over 500 lines, SQL such as ALTER TABLE, removed exported functions
- Lists changed test files and warns when code changed without any test changes
- Adds a screenshot checklist only when UI files changed
- Prints a template in English or Japanese (summary, changes, testing, risks, rollout and rollback, screenshots, checklist) that the agent fills in after reading the diff
How to use
python scripts/pr_context.py --base main --lang en
Ask the agent to write the PR description for the current branch. Works with Claude, Codex, Hermes Agent and Cursor. It creates the PR (for example with gh pr create) only when you ask.
Requirements
- Python 3 (standard library only)
- Git
Caveats
- The script is read-only; it never pushes or creates pull requests.
- Risk flags are hints from file paths and a few line patterns; the final text is based on reading the diff.
- It never claims test results that were not actually run; unknown parts stay as comments.
How to install
- Unzip the downloaded file (it contains a
pr-description-writer/folder withSKILL.md). - Copy the whole folder into your agent's skills folder.
- Claude:
~/.claude/skills/(per project:.claude/skills/) - Hermes Agent:
~/.hermes/skills/ - Codex:
~/.agents/skills// Cursor:~/.cursor/skills/ - Claude app (claude.ai): upload the ZIP in Customize → Skills
- Claude:
- Restart the agent and check that the skill appears in its skill list.
Seller
HackStar
Skills that make everyday developer work faster and safer: Git, testing, APIs and security.
8 published skills