Initial commit

skills/update-pr/README.md

@@ -0,0 +1,60 @@
+# Update PR Skill
+
+> Creates comprehensive PR descriptions by systematically reviewing all changes
+
+## Overview
+
+This skill helps Claude create thorough PR descriptions that document every meaningful change in a branch - not just the headline feature, but also bug fixes, test improvements, configuration changes, and documentation updates.
+
+**For complete plugin documentation, see the [main README](../../README.md).**
+
+## Quick Reference
+
+**Example prompts:**
+```
+"Update the PR description"
+"Prepare this PR for review"
+"Document the changes in this branch"
+"Write a comprehensive PR summary"
+```
+
+**What it does:**
+- Systematically inventories ALL changed files and commits
+- Categorizes changes (features, fixes, tests, docs, config)
+- Creates structured PR descriptions with user impact section
+- Saves to `/tmp/pr-summary.md` and updates PR via `gh pr edit`
+
+**Allowed tools:** Bash, Read, Write, Edit, Glob, Grep
+
+## How It Works
+
+The skill runs a 5-phase workflow:
+
+1. **Inventory** - Detects base branch (from PR or default), runs git diff/log commands
+2. **Categorization** - Groups files by type (core, fixes, tests, docs, config)
+3. **Analysis** - Reviews each commit to understand what/why/impact
+4. **Documentation** - Creates structured PR description
+5. **Update** - Saves to temp file, optionally updates PR
+
+See [SKILL.md](SKILL.md) for the complete workflow details.
+
+## Tips for Best Results
+
+1. **Let it run all phases** - Don't interrupt the systematic review
+2. **Review before updating** - Claude will show you the summary first
+3. **Provide context** - Mention important context Claude can't see in the code
+4. **Base branch detection** - Uses PR's actual base branch (supports release backports, non-default targets)
+
+## Requirements
+
+- **gh CLI** - GitHub's official CLI, authenticated
+- **Git** - For diff and log commands
+
+## Documentation
+
+- **[SKILL.md](SKILL.md)** - Complete workflow for Claude
+- **[EXAMPLES.md](EXAMPLES.md)** - Good vs bad PR description examples
+
+## License
+
+MIT - See [LICENSE](../../LICENSE)