Automate PR Descriptions with the pr-description Skill

Where this fits

You've just finished a feature branch, committed your changes, and are about to push and open a pull request. Or you've already pushed, but the PR description is now stale after additional commits. Manually writing and updating PR titles and bodies is tedious and error-prone. The pr-description skill automates this by generating the title and body directly from the diff, ensuring they always reflect the current state of your work.

Why agents benefit

• Works from the diff, not memory: The agent analyzes the actual changes, so descriptions are accurate and comprehensive.
• Auto-triggers at key points: Runs before gh pr create and after an agent pushes to a branch with an existing PR, keeping descriptions fresh without extra prompts.
• Loads prerequisite skills: Automatically applies simple-english and i-have-adhd to produce clear, concise, and focused PR text.
• On-demand invocation: Users can trigger it with /pr-description or a natural language request, making it flexible.
• Respects workflow boundaries: Ignores human-only pushes and avoids adding git hooks, so it doesn't interfere with manual processes.

Practical scenarios

Creating a new pull request

When you're ready to open a PR, the agent invokes the skill before gh pr create. It generates a title and body from the diff and posts them, saving you from writing from scratch.

Updating an existing PR after new commits

After the agent pushes to a branch that already has an open PR, the skill automatically runs gh pr edit with a fresh title and body. This prevents the all-too-common problem of a PR description that describes only the first commit.

User requests a description on demand

If you type /pr-description or ask "write the PR description," the agent generates it immediately from the current diff, without waiting for approval. This is handy for last-minute changes or when you need a quick summary.

Add it to your agent workflow

Install the skill with:

npx skills add AlemTuzlak/skills --skill pr-description

Once installed, configure your agent to load it when appropriate. For example, before running gh pr create or after pushing to a branch with an open PR, the agent will automatically use the skill to generate and post the PR details.

Compare before adopting

Before integrating this skill, compare it with other PR description tools or your current manual process. Look at quality signals like stars (currently 39) and recent commits, check how actively it's maintained, and see if it fits your existing agent workflow. Consider whether you need a simpler solution or one that integrates with other tools like CI or project management.

Why it is worth tracking

The pr-description skill addresses a real pain point with a clever approach—working from the diff and auto-updating descriptions. Its growing community and active development suggest it will improve over time. For more details, see the skill page at OpenAgentSkill. Track it to see if it adds support for other platforms, customization options, or better integration with code review workflows. Evaluate it when your PR process needs automation that keeps pace with your development speed.