Maintainer Briefing

SkillDev tools

Generate a prioritized maintainer briefing from current GitHub repository state, including issue/PR dependencies, CI, review blockers, regressions, and drift.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Maintainer Briefing skill

What this skill tells your AI

The instructions your AI receives, as published by caarlos0/dotfiles in skills/maintainer-briefing/SKILL.md and read by ahel’s review.

Allocate maintainer attention; do not perform detailed code review or invent merge recommendations.

Resolve the repository argument or use:

gh repo view --json nameWithOwner -q '.nameWithOwner'

Fetch open pull requests and issues with gh, including review decisions, unresolved threads, labels, checks, timestamps, authors, and size. Fetch details only for candidates likely to appear in the report.

Dependency map

Build an issue/PR map from closing references, linked issues, comments, commit messages, and overlapping symbols when available. Detect:

  • issues with open, merged, or superseded fixes;
  • PRs whose premise changed because another PR merged first;
  • reopened regressions or partial fixes;
  • stale file and line references after ports or large insertions;
  • contradictory issues or PRs touching the same behavior;
  • base-branch failures affecting multiple pull requests.

Do not infer a dependency from similar titles alone.

Prioritization

Rank by:

  1. security or data-loss risk;
  2. contributor blocked on a maintainer decision;
  3. regression or broken release/CI;
  4. user already engaged and context still warm;
  5. small, passing goodwill wins;
  6. stale cleanup.

Estimate effort from actual scope and decision complexity, not line count alone. Deduplicate items across sections.

Report

Keep the report compact:

Critical

At most three security, regression, release, or contributor-blocking items.

Decisions Needed

Items requiring maintainer product/API direction rather than code review.

Easy Wins

Small, passing, low-risk work with the exact next action and effort estimate.

Deep Focus

At most three high-leverage reviews or investigations, each under 30 minutes unless unavoidable.

Dependency and Drift

Superseded fixes, reopened issues, stale citations, contradictory premises, and safe close/ping candidates.

Snapshot

Open PR/issue counts, items waiting on the maintainer, CI failures, and backlog distribution.

Close with the single best action today, fastest contributor goodwill win, and what is safe to ignore. Ground every item in fetched data and use #number references consistently.

Signals

GitHub stars
220
Forks
11
Last commit
Sep 2026
Advanced
Item type
skill
Key
maintainer-briefing
Source
github.com/caarlos0/dotfiles