Skip to main content
skill CX Codex

pr-description · justxor — Claude Code skill: what it does, how to install

pr-description generates clear pull request titles and descriptions by inspecting branch commits and diffs against main.

MIT ★ 353 updated 2026-10-01

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add justxor/claude-code-pro-course --skill pr-description -a claude-code
Open on GitHub

What pr-description does

The skill inspects your current git branch, reading up to thirty recent commit messages alongside the output of git diff main...HEAD. It uses template.md to format the overview for reviewers, emphasizing why changes were made and where reviewers need to look closely. When test details cannot be deduced from the diff, it deliberately leaves that section blank for the author rather than guessing.

Execution relies on specific shell access: git diff, git log, git status, git branch, plus file reading tools like Read and Grep. Importantly, the skill outputs the description text to the screen; running gh pr create happens only if you explicitly ask to open the PR.

What it helps with

  • write clear pull request overviews directly from branch diffs
  • highlight critical code paths for incoming reviewers
  • outline verification steps for branch changes
  • run gh pr create only after explicit confirmation

Example prompts for the agent

  • Prepare a pull request description for my current branch
  • Review git diff against main and draft the PR summary
  • Draft the PR description and submit it using gh pr create

How to install pr-description

1Skills CLI (Vercel)

npx skills add justxor/claude-code-pro-course --skill pr-description -a claude-code

2Manually: put the files in place

~/.claude/skills/pr-description/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pr-description/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about pr-description

How to install pr-description in Claude Code?

Run npx skills add justxor/claude-code-pro-course --skill pr-description -a claude-code in your terminal.

What does pr-description do?

It parses your branch commits and diff against main, structuring a ready-to-use PR title and summary according to template.md.

Does pr-description open pull requests automatically?

No, it prints the summary text first. It only executes gh pr create if you explicitly instruct it to create the pull request.

Source text

SKILL.md · MIT
---
name: pr-description
description: Готовит заголовок и описание pull request по изменениям в ветке. Используй, когда просят описать PR, подготовить pull request или написать описание изменений.
allowed-tools: Bash(git diff:*), Bash(git log:*), Bash(git status), Bash(git branch:*), Read, Grep
---

# PR description

## Контекст
- Ветка: !`git branch --show-current`
- Коммиты: !`git log --oneline main..HEAD 2>/dev/null | head -30`

## Шаги
1. Изучи `git diff main...HEAD` и коммиты.
2. Сформируй описание по шаблону [template.md](template.md).
3. Пиши для ревьюера: что и **зачем**, на что смотреть внимательно, как проверить.
4. Не выдумывай: если не знаешь, как тестировали, — оставь пункт для автора.
5. Выведи результат. Создавать PR (`gh pr create`) — только если пользователь явно попросил.

© justxor · MIT · justxor/claude-code-pro-course

Similar skills

All skills for Git and GitHub →

pr-description by other authors comes first.

From the same set15

The whole set →
fix-issue fix-issue — a skill that runs the full cycle of fixing a GitHub issue by number — from analysis and test to commit. CX Codex +1 ★ 353repo stars test-runner test-runner runs tests on modified files, diagnoses failures, and distinguishes real code bugs from outdated test suites. CX Codex ★ 353repo stars debugger The debugger subagent reproduces errors and failing tests, tracks down their cause, then checks the fix. Use it when a stack trace or unexpected behavior needs investigation. CX Codex ★ 353repo stars docs-writer docs-writer — a subagent that updates README, API docs, code comments, and ADRs whenever your code changes. It verifies actual behavior and keeps examples aligned with reality. CX Codex ★ 353repo stars architect The architect subagent examines a project before implementation, compares design options, and lays out a change plan. Use it to scope a feature or a major refactor. CX Codex ★ 353repo stars code-reviewer code-reviewer reads your diff, flags security holes, missing tests and edge cases, then returns a severity-sorted report with a file and line for each fix. CX Codex ★ 353repo stars write-tests write-tests generates unit tests for a chosen file or function while matching existing project patterns. It runs new checks and flags discovered bugs instead of bending assertions. CX Codex +1 ★ 353repo stars commit This skill reviews your working changes and creates a git commit in Conventional Commits format. Use it when you want an agent to make a commit that follows the repository’s message style. CX Codex +1 ★ 353repo stars

Project sponsors

Companies that keep this analytics open