What each family solves

Start with the baseline

Three plugins are the strongly recommended starting set. Take all three, then add families against a problem you have today:

Plugin Why it is in the baseline
magpie-setup Install this one first — nothing else works without it. It is what installs, upgrades, configures and adopts everything else, and it carries the secure-isolation skills that sandbox your agent.
magpie-agent-guard The deterministic pre-execution guard: a hook that inspects each shell command before it runs and denies the dangerous shapes outright. It is not a family and has no skills of its own — it is a safety net under whatever else you install.
magpie-utilities list-skills, so you can see what is actually installed, plus skill authoring and a path to report framework bugs upstream. Small, and the thing you reach for when something is not behaving.

This is not an arbitrary recommendation: it is exactly the set a project commits as its floor when it adopts Magpie (Installation or Adoption?). What a project recommends to everyone who clones it is what you should have yourself.

Isolation belongs here too. It is not a plugin but a run — Step 3 of the quick start — and it ships inside magpie-setup.

The ten families

Skills ship in ten families. Install the ones that match a problem you have today — you are not meant to take all of them.

Plugin Skills The problem it solves What it offers
magpie-setup 10 Your agent can read every credential on your machine, and you have no way to tell whether it is sandboxed right now. A filesystem sandbox, a clean-env wrapper, a status line that shows sandbox state, and a red banner before any bypass. Plus install, upgrade, and drift checks. You must install this one first — it is what installs everything else.
magpie-security 15 Security reports arrive by mail and must be triaged, fixed, and disclosed on a clock — with nothing leaking early. A 16-step lifecycle: intake from the mailbox, validity triage, canned responses, fix drafting, CVE allocation, advisory and publication. Drafts land in Gmail; nothing is ever sent for you.
magpie-release-management 10 An ASF release is a long checklist where one missed step invalidates the vote. RC cut, RC verification (signatures, hashes, LICENSE/NOTICE, no stray binaries), the [VOTE] thread, the tally, promotion, [ANNOUNCE], archive sweep, audit log. The agent never holds your signing key and never publishes.
magpie-pr-management 8 The PR queue grows faster than you can read it, and the oldest ones quietly rot. Queue triage into ready / needs-review / waiting-on-author, deep code review with blocking vs non-blocking findings, reviewer routing, express-lane merge, stale sweep, and queue statistics.
magpie-issue 8 A backlog full of duplicates, unreproducible reports, and issues nobody has read in a year. Triage with proposed labels, duplicate clustering, reproduction attempts across versions, fix drafting, reassessment of old issues, stale sweep, and backlog stats.
magpie-repo-health 7 Slow rot you only notice when it breaks: vulnerable deps, unpinned actions, licence drift, flaky tests. Read-only audits for dependency CVEs, dependency licences, LICENSE/NOTICE compliance, Actions workflow security, obsolete runner labels, and flaky-test patterns — plus a skill that fixes what they find.
magpie-contributor-growth 6 Contributors who have earned committership go unnoticed because nobody is tracking the signal. Activity sweeps against a review threshold, readiness tracking, sentiment signals, nomination briefs for the PMC, and committer / post-vote onboarding checklists.
magpie-utilities 5 You want to write your own skills, or find out what is actually installed. Skill authoring and restructuring, a state reconciler, a live index of installed skills, and a path to report framework bugs upstream. In the baseline.
magpie-mentoring 4 Newcomers open one PR, hit a wall of unwritten conventions, and never come back. First-contact welcome comments, plain-language explanations of an issue for someone new, good-first-issue authoring, and a sweep that keeps that backlog honest.
magpie-pairing 2 You want the obvious problems found before a reviewer spends their time on them. A structured self-review of your own diff, and a multi-agent adversarial review that verifies its findings before reporting them.
Suggest a change