pr-writing

Analyze code commits and generate pull request descriptions with GitHub API.

2|Updated May 15, 2026
One-click install
npx skills add https://github.com/bdbch/ai-dotfiles --skill pr-writing-bdbch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-writing
Source: https://github.com/bdbch/ai-dotfiles/tree/main/skills/pr-writing
Command: npx skills add https://github.com/bdbch/ai-dotfiles --skill pr-writing-bdbch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill addresses the challenge of writing clear, comprehensive pull request descriptions, ensuring effective communication and efficient code reviews.

Core Features & Use Cases

  • Analyze Diffs: Automatically analyze code changes and suggest relevant information for PR descriptions.
  • Apply Templates: Utilize project-specific templates for standardized PR descriptions.
  • Link Issues: Automatically link related GitHub issues to PR descriptions for context.
  • Categorize Changes: Organize changes by category for easy reference and changelog generation.
  • Changelog Entries: Generate changelog entries based on PR descriptions.
  • Guide Reviewers: Provide reviewer notes and guidance for effective code reviews.
  • Use Case: When you need to submit a pull request and want to ensure that your description is clear, informative, and well-structured.

Quick Start

Use the pr-writing skill to analyze the diff of your current branch against the base branch and generate a pull request description.

Frequently Asked Questions about pr-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically generate a pull request description from my commits?

This skill generates pull request descriptions by analyzing your code diffs and commit messages to suggest a comprehensive summary including changed files and relevant categories. It uses GitHub API access to fetch related issues and link them for context.

Can I use a custom template for PR descriptions when analyzing code diffs?

Yes, you can apply project-specific templates for PR descriptions. The skill standardizes code review descriptions by structuring analyzed code diffs into a clear, consistent format across your repository.

How does commit analysis link related GitHub issues to a PR description?

Commit analysis links related GitHub issues by requiring GitHub API access to fetch issue details and automatically attaching them to your PR description. This provides necessary context for reviewers to understand the code changes.

What is the best way to generate changelog entries from pull request descriptions?

Generate changelog entries from PR descriptions by categorizing code changes during commit analysis. The skill organizes changes by category, allowing you to automatically create changelog entries based on the structured PR description.

Do I need GitHub API access to analyze code commits and generate PR descriptions?

Yes, you need GitHub API access to analyze code commits and generate PR descriptions. The skill requires this access to fetch pull request and related issue details for linking context within the generated description.

How do I add reviewer notes and guidance to my pull request description?

Add reviewer notes and guidance to your pull request description by using the skill to analyze commit changes and automatically generate reviewer guidance. This ensures effective code reviews by providing structured context directly within the PR.