cleanup-stale-prs

name	cleanup-stale-prs
description	Identify and optionally close stale GitHub pull requests using `gh`, with dry-run support and a configurable exempt label. Use when asked to clean stale PRs, close inactive PRs, or run PR hygiene.

Cleanup Stale PRs

Use this skill for GitHub pull request hygiene. Start with a dry run, review the candidates, and only use --apply when the user wants the closures to happen.

Prerequisites

• gh is installed and authenticated for the target repository.
• python3 is available.
• Prefer the bundled script over ad-hoc shell pipelines.

Bundled Resource

• scripts/cleanup_stale_prs.py lists stale PRs and optionally closes them.

Default Workflow

Commands below assume the repo root is the current working directory. Invoke the bundled script via its full path under .agents/skills/cleanup-stale-prs/.

python3 ./.agents/skills/cleanup-stale-prs/scripts/cleanup_stale_prs.py --dry-run

python3 ./.agents/skills/cleanup-stale-prs/scripts/cleanup_stale_prs.py \
  --dry-run \
  --repo owner/repo \
  --stale-days 5 \
  --exempt-label do-not-close

python3 ./.agents/skills/cleanup-stale-prs/scripts/cleanup_stale_prs.py \
  --apply \
  --stale-days 3 \
  --exempt-label wip

Behavior

• Uses gh pr list --json to inspect open PRs, including titles and PR descriptions.
• Treats a PR as stale when updatedAt is older than the cutoff. The default threshold is 7 days.
• Excludes PRs whose labels include the exempt label, case-insensitive.
• In dry-run mode, prints a grouped summary with counts, change-type breakdowns, and detailed candidates grouped by inferred topic.
• Adds a close comment when --apply is used.

Notes

• updatedAt can be bumped by bots, comments, or status changes. If that is too noisy, switch to a commit-recency variant.
• Keep dry-run as the default. Do not close PRs unless the user asked for it.