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
npx skills add justxor/claude-code-pro-course --skill pr-description -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/pr-description/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/pr-description/
1Skills CLI (Vercel)
npx skills add justxor/claude-code-pro-course --skill pr-description -a codex2Manually: put the files in place
.agents/skills/pr-description/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add justxor/claude-code-pro-course --skill pr-description -a cursor2Manually: put the files in place
.cursor/skills/pr-description/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install justxor/claude-code-pro-course starter-kit/.claude/skills/pr-description2Manually: put the files in place
.github/skills/pr-description/SKILL.md1Skills CLI (Vercel)
npx skills add justxor/claude-code-pro-course --skill pr-description -a gemini-cli2Platform CLI
gemini skills install https://github.com/justxor/claude-code-pro-course --path starter-kit/.claude/skills/pr-descriptionManually: put the files in place
.devin/skills/pr-description/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.