Superpowers for Agent Zero

An Agent Zero community plugin that adapts the Superpowers v6.3.0 software-development methodology through Agent Zero's native Skills system.

Purpose

Superpowers is a methodology adapter, not a second Agent Zero runtime. Version 2 keeps the integration deliberately small:

• all 14 upstream Superpowers skills are pinned and verified offline;
• using-superpowers is injected before each prompt cycle, including after context compaction;
• applicable skills load through Agent Zero's native skills_tool and Skills UI;
• delegation and execution use Agent Zero's existing tools and the optional bundled Orchestrator skill;
• approvals remain in the ordinary conversation and finishing-branch workflow.

The plugin does not provide a Methodology Map, Visual Companion runtime, task supervisor, worker scheduler, automatic Git integration, or separate approval UI. Upstream Visual Companion resources remain part of the verified skill payload for fidelity, but this adapter does not start their server or manage a browser companion. Continue text-only unless a host-native visual tool is available and the user asks to use it.

Installation

Place or clone this repository at /a0/usr/plugins/superpowers, then enable it in Agent Zero's Plugins UI. The install hook verifies UPSTREAM.lock.json, the upstream license, and every included skill file. It installs no dependencies, starts no process, opens no port, and modifies no Agent Zero core file.

Global, project, profile, and project-profile activation are owned by Agent Zero. Version 2 has no plugin-specific settings.

Native workflow

The bootstrap tells the agent to check for applicable skills before acting. An upstream reference such as superpowers:systematic-debugging maps to the native Agent Zero skill name systematic-debugging:

skills_tool action=load skill_name=systematic-debugging

Agent Zero stores loaded skills in chat history and reattaches them after compaction. When Superpowers calls for delegation, use the host's available agent facilities. For external terminal or headless coding agents, load Agent Zero's bundled orchestrator skill; Superpowers does not wrap it in another runner.

Human approval is requested in chat. Implementation stops at reviewed evidence until the user selects the merge, pull-request, keep, or discard path described by finishing-a-development-branch.

Integrity

UPSTREAM.lock.json pins the v6.3.0 tag, commit, tree, license, complete 14-skill directory, modes, sizes, and SHA-256 hashes. Bootstrap generation fails closed if protected content is missing, added, changed, or symlinked. Ordinary install, startup, and prompt handling are offline.

Maintainer refreshes use a clean checkout of the exact pinned tag and the vendor_from_source hook. See docs/vendor-refresh.md.

Verification

Run from the Agent Zero repository root with the framework runtime:

python -m pytest -q usr/plugins/superpowers/tests

The focused suite covers the manifest, repository boundary, upstream identity, tamper detection, native bootstrap contract, and maintainer vendor import.

License and attribution

Superpowers is Copyright (c) 2025 Jesse Vincent and is distributed under the MIT License. This community adapter preserves the upstream license and records the exact included payload in UPSTREAM.lock.json.