New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Maintainer Briefing

by caarlos0 in caarlos0/dotfiles

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

MITAuto-check passedDevelopment

Install Maintainer Briefing

skills CLI
$ npx skills add caarlos0/dotfiles --skill maintainer-briefing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install caarlos0/dotfiles maintainer-briefing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/caarlos0/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/maintainer-briefing .claude/skills/maintainer-briefing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
maintainer-briefing
GitHub stars
220
Token cost
~607 tokens
SKILL.md length
289 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 6 steps: security or data-loss risk; → contributor blocked on a maintainer… → regression or broken release/CI; → …
  • Development work in your project
  • SKILL.md covers Dependency map, Prioritization and Report
  • Calls gh

What it does

Maintainer Briefing is an agent skill from caarlos0/dotfiles. Generate a prioritized maintainer briefing from current GitHub repository state, including issue/PR dependencies, CI, review blockers, regressions, and drift.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with GitHub. The licence is MIT.

When your agent uses it

  • Development work in your project

Example prompts

  • “/maintainer-briefing”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  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.

What it can do on your machine

Read from SKILL.md and the folder at commit 892360f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Maintainer Briefing loads about 607 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 289 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~607

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from caarlos0/dotfiles at commit 892360f, republished under its MIT licence (© caarlos0). 289 words, ~607 tokens.

Download SKILL.mdSave it as .claude/skills/maintainer-briefing/SKILL.md (or your agent's skills folder).
name
maintainer-briefing
description
Generate a prioritized maintainer briefing from current GitHub repository state, including issue/PR dependencies, CI, review blockers, regressions, and drift.
user_invocable
true

Maintainer Briefing

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

Resolve the repository argument or use:

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

© caarlos0, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/maintainer-briefing of caarlos0/dotfiles.

Open the folder on GitHubat commit 892360f

Compare with similar skills

Maintainer Briefing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Maintainer Briefing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Maintainer Briefing this skillcaarlos0/dotfiles220—~607Automated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT
Check PRonyx-dot-app/onyx32k2 repos~2.3kAutomated safety check: PassMIT
Setup Matt Pocock Skillsbestofjs/bestofjs3.1k20 repos~1.7kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed

  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

  • Check PR

    onyx-dot-app/onyx

    Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.

    32k GitHub starsUsed in 2 repos~2.3k tokens
    DevelopmentAuto-check passed

  • Setup Matt Pocock Skills

    bestofjs/bestofjs

    Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout.

    3.1k GitHub starsUsed in 20 repos~1.7k tokens
    DevelopmentAuto-check passed

  • Contributor-First PR Merge

    HKUDS/OpenHarness

    Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed

  • Create Pull Request

    cline/cline

    Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed

More from caarlos0/dotfiles

All 20 skills in this repo

  • CLI Design

    caarlos0/dotfiles

    Design and review command-line interfaces for usability, automation, safety, accessibility, and long-term compatibility.

    220 GitHub stars~4.2k tokensUpdated today
    Auto-check passed

  • Dependabot Merge

    caarlos0/dotfiles

    Review and merge open dependency pull requests from Dependabot, Renovate and similar bots across the goreleaser organization and the caarlos0 user.

    220 GitHub stars~5k tokensUpdated today
    Auto-check passed

  • Gh CLI

    caarlos0/dotfiles

    Use GitHub CLI efficiently for pull requests, CI checks, workflow runs, logs, and merge status.

    220 GitHub stars~2.5k tokensUpdated today
    Auto-check passed

  • Tui Design

    caarlos0/dotfiles

    Design terminal user interfaces and interactive CLIs that stay usable, accessible, and scriptable.

    220 GitHub stars~3k tokensUpdated today
    Auto-check passed

  • Dashboard

    caarlos0/dotfiles

    Design and review dashboards that are informative, honest, accessible, and visually polished, independent of any tool.

    220 GitHub stars~4.1k tokensUpdated today
    Auto-check passed

  • Gh Doc Author

    caarlos0/dotfiles

    Author and revise clear GitHub internal documentation, including design docs, proposals, decision records, runbooks, status updates, and handoffs.

    220 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Maintainer Briefing

What does Maintainer Briefing do?

Generate a prioritized maintainer briefing from current GitHub repository state, including issue/PR dependencies, CI, review blockers, regressions, and drift. Maintainer Briefing is an agent skill from caarlos0/dotfiles. Generate a prioritized maintainer briefing from current GitHub repository state, including issue/PR dependencies, CI, review blockers, regressions, and drift.

When should I use Maintainer Briefing?

Maintainer Briefing fits situations like: development work in your project.

How do I install Maintainer Briefing in Claude Code?

Run `npx skills add caarlos0/dotfiles --skill maintainer-briefing -a claude-code`. Or copy the skill folder (skills/maintainer-briefing in caarlos0/dotfiles) into .claude/skills/maintainer-briefing in your project. Claude Code loads it when a task matches its description.

How do I install Maintainer Briefing in Codex?

Run `npx skills add caarlos0/dotfiles --skill maintainer-briefing -a codex`. Or copy the skill folder (skills/maintainer-briefing in caarlos0/dotfiles) into .agents/skills/maintainer-briefing in your project. Codex loads it when a task matches its description.

Can I use Maintainer Briefing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add caarlos0/dotfiles --skill maintainer-briefing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/maintainer-briefing, .gemini/skills/maintainer-briefing, .github/skills/maintainer-briefing and .opencode/skills/maintainer-briefing in your project.

What does Maintainer Briefing need to run?

Going by SKILL.md and its folder, Maintainer Briefing needs the command-line tools its instructions call (gh).

Does Maintainer Briefing access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Maintainer Briefing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Maintainer Briefing use?

Maintainer Briefing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Maintainer Briefing use?

About 607 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Maintainer Briefing?

Skills that share tags, products or a category with Maintainer Briefing: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Greploop (onyx-dot-app/onyx, 32k stars), Check PR (onyx-dot-app/onyx, 32k stars) and Setup Matt Pocock Skills (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Maintainer Briefing?

caarlos0 (a GitHub user) maintains it in caarlos0/dotfiles, which has 220 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 9, 2026.

Source: caarlos0/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.