Maintainer Briefing
SkillDev toolsGenerate 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.
No other account needed.
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:
- security or data-loss risk;
- contributor blocked on a maintainer decision;
- regression or broken release/CI;
- user already engaged and context still warm;
- small, passing goodwill wins;
- 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