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.

ClaudeHermes AgentCodexCursorMIT (modify, redistribute and use commercially)Python

What it does

Writes a pull request description from what the branch actually changes.

  • The bundled script reads git diff base...HEAD and git 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

  1. Unzip the downloaded file (it contains a pr-description-writer/ folder with SKILL.md).
  2. 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
  3. Restart the agent and check that the skill appears in its skill list.

Step-by-step install for Windows / Mac and each agent

Seller

HackStar

Skills that make everyday developer work faster and safer: Git, testing, APIs and security.

8 published skills

Seller profile and all skills