# Pr Blocker Summarizer

> Summarizes 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.

- **Type:** Skill
- **Install:** `agentstack add skill-francyjglisboa-agent-skills-platform-pr-blocker-summarizer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [FrancyJGLisboa](https://agentstack.voostack.com/s/francyjglisboa)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [FrancyJGLisboa](https://github.com/FrancyJGLisboa)
- **Source:** https://github.com/FrancyJGLisboa/agent-skills-platform/tree/main/references/examples/pr-blocker-summarizer
- **Website:** https://francyjglisboa.github.io/agent-skills-platform/

## Install

```sh
agentstack add skill-francyjglisboa-agent-skills-platform-pr-blocker-summarizer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
python3 scripts/run_pipeline.py --input prs.json --output digest.json
```

Output JSON shape:

```json
{
  "total": 7,
  "blocked": [{"title": "...", "reasons": ["failing checks"]}],
  "ready": ["..."],
  "summary": "7 open · 3 blocked · 2 ready to merge"
}
```

## Gotchas

- **`blocked` + `ready` does not equal `total`.** A PR is `ready` only when
  `checks` is explicitly `passing` *and* `review` is explicitly `approved`. A PR
  with no blockers but a missing `checks` field 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.
- **`state` is read from the input but never filtered on.** A closed or merged PR
  left in the export is counted in `total` and classified like any open one. Filter
  the export before running if it may contain non-open PRs.
- **`review: pending` counts 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_days` silently 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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [FrancyJGLisboa](https://github.com/FrancyJGLisboa)
- **Source:** [FrancyJGLisboa/agent-skills-platform](https://github.com/FrancyJGLisboa/agent-skills-platform)
- **License:** MIT
- **Homepage:** https://francyjglisboa.github.io/agent-skills-platform/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-francyjglisboa-agent-skills-platform-pr-blocker-summarizer
- Seller: https://agentstack.voostack.com/s/francyjglisboa
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.