Table of Contents generated with DocToc

PR management skill family

Maintainer-facing PR-queue management for projects with a public contributor PR queue. Three skills that compose into a complete triage + review pass:

  1. Triage — sweep open PRs, classify against the project's quality criteria, propose a disposition (draft / comment / close / rebase / rerun / mark ready / ping), execute on maintainer confirmation.
  2. Stats — read-only summary tables of the open PR backlog, grouped by area label, so the maintainer can see where queue pressure is sitting before / after a triage sweep.
  3. Code review — deep, line-aware code review one PR at a time. Reads the diff, applies the project's review criteria, drafts an APPROVE / REQUEST_CHANGES / COMMENT review with inline comments, posts on confirmation.

Why a framework skill family? These skills were originally maintained inside apache/airflow as breeze pr auto-triage and breeze pr stats — useful for any ASF project with a meaningful contributor-PR queue, but locked behind airflow-specific toolchain. Lifting them into the framework lets other adopters reuse the playbook with their own adopter-config files for project-specific knobs (committers team handle, area-label prefix, comment-template wording, CI-check → doc-URL map, review-criteria source files).

Skills

SkillPurpose
pr-management-triageFirst-pass triage. Successor to breeze pr auto-triage.
pr-management-statsRead-only summary tables grouped by area label.
pr-management-code-reviewDeep code review, one PR at a time.

Adopter contract

The skills resolve project-specific content from these files in the adopter's <project-config>/ directory:

FileUsed by
pr-management-config.mdpr-management-triage, pr-management-stats
pr-management-triage-comment-templates.mdpr-management-triage
pr-management-triage-ci-check-map.mdpr-management-triage
pr-management-code-review-criteria.mdpr-management-code-review

The framework currently ships with airflow-flavoured defaults inline in the supporting files of each skill (e.g. pr-management-triage/comment-templates.md embeds airflow's PR-quality-criteria URL). A follow-up PR will complete the extraction so the skills read exclusively from <project-config>/. Until then, non-airflow adopters override by forking the relevant supporting file into their own .claude/skills/<skill-name>/.

Cross-references