Search guides, workflows, and reference pages.

Docs/Skill tools

Install & first runs

Install just this family — one plugin, 6 skills. Discover, author, and maintain skills, and report framework bugs.

Once you have added the marketplace:

/plugin install magpie-utilities@apache-magpie

New to Magpie? The quick start walks the whole path in one place — install, the first /magpie-setup:setup run, and a recording of it happening — plus the other agents and the secure-isolation setup to run next.

The first utilities skill you run opens with a one-minute welcome guide: the typical flow, what needs configuring, what to ask it, and how to make it yours. Dismiss it, or hide it for good, from its last line; “show the utilities welcome again” or /magpie-setup:welcome-guide utilities brings it back.

Before the first run

Nothing here has to be configured. These skills read the file below when it exists — yours in your personal layer or the project’s in .apache-magpie-overrides/ — and fall back to a documented default when it does not.

Optional. Each has a documented fallback; absent, the skill still runs.

File What it carries Read by
project.md Project manifest. Identity, repositories, mailing lists, tools enabled, CVE tooling, GitHub project-board + issue-template field declarations. The single file every skill reads to resolve project-scoped references. list-skills, optimize-skill, report-framework-issue, skill-reconciler, write-skill

Works well with

Third-party packages, none of them required: this family works with none of them installed, and Magpie neither bundles nor depends on any. They are named because they are what a maintainer goes looking for next, and because the answer differs by agent.

Superpowers — obra (community)

A skills library and development methodology: brainstorming, plan writing, subagent-driven execution, systematic debugging.

With this family: write-skill and optimize-skill author Magpie skills; Superpowers’ brainstorming and plan-writing skills are the discipline for deciding what a skill should do before writing it.

Available on Claude Code, OpenAI Codex CLI, VS Code / GitHub Copilot, Google Antigravity, Cursor, OpenCode.

Installing it means first adding a marketplace Magpie does not publish — obra/superpowers-marketplace. The install flow asks before it does, and names whose it is.

Ships a plugin manifest per harness and one shared skills/ tree, the same shape Magpie uses, so it is not a Claude Code-only package.

Install commands per agent are in Companion skill packages.

Try these first

Illustrative shapes, not real transcripts — your output will differ. Nothing below sends, merges, or posts anything without you confirming it.

List everything installed.

/magpie-utilities:list-skills

A list-skills run showing the three plugins installed here and the seven families available in the marketplace but not installed

Author a new skill.

/magpie-utilities:write-skill

A write-skill run that drafted a new skill with conforming frontmatter, pre-flight and hard rules, and flagged the missing eval suite

Report a framework bug upstream.

/magpie-utilities:report-framework-issue

A report-framework-issue run that searched the framework repository for an existing report, found none, and drafted one

Suggest a change