| name | pr-retro |
| description | Learn from PR outcomes. |
| practices | ["dora-metrics","sre","lean-startup"] |
| hexagonal_role | supporting |
| consumes | [] |
| produces | [".agents/research/*.md"] |
| context_rel | [] |
| skill_api_version | 1 |
| context | {"window":"fork","intent":{"mode":"task"},"sections":{"exclude":["HISTORY"]},"intel_scope":"topic"} |
| license | MIT |
| compatibility | Requires git, gh CLI |
| metadata | {"author":"AI Platform Team","version":"1.0.0","tier":"contribute","internal":false} |
| allowed-tools | Read, Write, Bash, Grep, Glob |
| output_contract | .agents/learnings/YYYY-MM-DD-pr-*.md |
PR Retro Skill
Learn from PR outcomes by analyzing accept/reject patterns.
Overview
After a PR is merged or rejected, analyze what worked and what didn't to
improve future contributions.
Output: .agents/learnings/YYYY-MM-DD-pr-{repo}-{outcome}.md
When to Use:
- After a PR is merged (capture success patterns)
- After a PR is rejected (understand why)
- After receiving significant review feedback
- Periodically to review contribution patterns
Workflow
1. PR Discovery -> Find the PR to analyze
2. Outcome Analysis -> Merged/rejected/changes requested
3. Feedback Extraction -> What did reviewers say?
4. Pattern Identification -> What worked/didn't
5. Lesson Extraction -> Reusable learnings
6. Output -> Write retro document
Phase 1: PR Discovery
gh pr view <number> --json state,reviews,comments,mergedAt,closedAt
gh pr list --state all --author @me --limit 10
gh pr list -R <owner/repo> --state all --author @me --limit 10
Phase 2: Outcome Analysis
| Outcome | Meaning | Focus |
|---|
| Merged | Success | What worked? |
| Closed (not merged) | Rejected | Why? |
| Open (stale) | Ignored/abandoned | What went wrong? |
| Changes requested | Needs work | What feedback? |
gh pr view <number> --json state,mergedAt,closedAt,reviews
Phase 3: Feedback Extraction
gh pr view <number> --json reviews --jq
gh api repos/<owner>/<repo>/pulls/<number>/comments --jq
gh view <number> --json reviews --jq