pr-issue-documenterlisted
Install: claude install-skill MrCipherSmith/helyx
# PR & Issue Documenter
## Purpose
Analyzes PR commits and diffs to generate structured, accurate descriptions for GitHub PRs and linked issues. Handles the full lifecycle: PR description, sub-issue creation, parent issue updates, and contradiction detection with existing descriptions.
**Input**: PR URL, issue URL, and/or commit SHAs
**Output**: Updated PR body, created/updated issue body, parent issue link
## When to Use
- User provides PR link and asks for a description
- User asks to document changes in a PR
- User wants to create an issue for a PR
- User wants to update an existing issue with PR changes
- User provides commit SHAs and wants documentation
## Architecture
```
Step 1: Parse Input
|
Step 2: Collect Context (commits, diff, existing descriptions)
|
Step 3: Analyze Changes (categorize, group, identify patterns)
|
Step 4: Generate PR Description
|
Step 5: Handle Issue (create / update / skip)
|
Step 6: Apply Changes (gh pr edit, gh issue edit/create)
|
Step 7: Verify & Report
```
## Workflow
Copy this checklist and track progress:
```
Task Progress:
- [ ] Step 1: Parse input — extract PR URL, issue URL, commit SHAs
- [ ] Step 2: Collect context — fetch commits, diff, existing descriptions
- [ ] Step 3: Analyze changes — categorize, group, build key files table
- [ ] Step 4: Generate PR description
- [ ] Step 5: Handle issue — create, update, or skip
- [ ] Step 6: Apply changes via gh CLI
- [ ] Step 7: Verify and report results to