FrancyJGLisboa/agent-skills-platform / references/examples/pr-blocker-summarizer
pr-blocker-summarizer
UnverifiedSummarizes open pull requests into a blockers-first standup digest. Activates when the user asks to summarize open PRs, find blocked pull requests, generate a PR standup, or triage review backlog from a PR export.
PR Blocker Summarizer
Turn a JSON export of open pull requests into a blockers-first digest: which PRs are blocked (failing checks, requested changes, or stale), which are ready to merge, and a one-line count an agent can post to standup.
A bundled example skill — small but real, used to demonstrate the creator's validation, pipeline, and eval-rollout machinery.
Activation
Activates on "summarize open PRs", "what's blocking my PRs", "PR standup", "review backlog". Do not activate on general git/GitHub questions unrelated to triaging a set of PRs.
Input
A JSON array of PRs, each with title, state (open), checks
(passing/failing), review (approved/changes_requested/pending), and
age_days. Missing fields are treated conservatively (counted as not-blocked only
when clearly ready).
Run
python3 scripts/run_pipeline.py --input prs.json --output digest.json
Output JSON shape:
{
"total": 7,
"blocked": [{"title": "...", "reasons": ["failing checks"]}],
"ready": ["..."],
"summary": "7 open · 3 blocked · 2 ready to merge"
}
Gotchas
blocked+readydoes not equaltotal. A PR isreadyonly whenchecksis explicitlypassingandreviewis explicitlyapproved. A PR with no blockers but a missingchecksfield lands in neither list and vanishes from both counts. Never narrate the summary line as if the two numbers account for every PR — say "N blocked, M ready" and leave the remainder unclaimed.stateis read from the input but never filtered on. A closed or merged PR left in the export is counted intotaland classified like any open one. Filter the export before running if it may contain non-open PRs.review: pendingcounts as blocked ("awaiting review"). A PR opened five minutes ago is reported as a blocker. This is intentional for standup triage, but it inflates the blocked count on teams that open PRs early.- A non-numeric
age_dayssilently skips the stale check rather than erroring. An export with"age_days": "unknown"will never flag anything stale, and the digest gives no sign that the check did not run.
Anti-goals
- Does not call the GitHub API; it works on an exported PR list.
- Does not merge or comment on PRs; it only summarizes.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |