Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

SuperAgents Skill

A small, framework-neutral skill pack for bounded delegation, safe parallel dispatch, artifact-based handoff, interrupted-work recovery, and independent review—without imposing a product-development workflow.

Skills

skills/
├── delegating-to-subagents/
│   └── SKILL.md
├── dispatching-parallel-subagents/
│   ├── SKILL.md
│   └── references/effects-matrix.md
├── handing-off-agent-work/
│   ├── SKILL.md
│   └── references/partial-work-ledger.md
├── recovering-agent-progress/
│   ├── SKILL.md
│   └── references/ledger-protocol.md
└── reviewing-subagent-work/
    ├── SKILL.md
    └── references/repair-and-rereview.md

Selection guide

  • delegating-to-subagents — decide whether one bounded assignment is worth delegating, then define its contract.
  • dispatching-parallel-subagents — prove that two or more bounded assignments are independent before concurrent dispatch.
  • handing-off-agent-work — intentionally transfer work from a reliable live sender through durable artifacts and explicit status.
  • recovering-agent-progress — reconstruct interrupted or stale work when no reliable live sender can hand it off, with or without a ledger.
  • reviewing-subagent-work — independently validate a candidate artifact; load repair guidance only when findings require it.

Select only the active decision or workflow. The skills are independent and composable: delegation is optional, parallelism requires already-bounded assignments, handoff and recovery are mutually exclusive routes, and no end-to-end lifecycle is required.

Install with Pi

Install globally for the current user:

pi install git:github.com/xz-dev/SuperAgents-skill

Pi discovers all five skills from the conventional skills/ directory. Start a new Pi session after installation so the skills appear in its available-skills list. Pi loads their full instructions on demand; invoke one explicitly with, for example:

/skill:delegating-to-subagents

Other supported modes:

# Install only for the current trusted project
pi install git:github.com/xz-dev/SuperAgents-skill -l

# Try it for one Pi run without adding it to settings
pi -e git:github.com/xz-dev/SuperAgents-skill

# Update an installed, unpinned Git package
pi update git:github.com/xz-dev/SuperAgents-skill

# Remove it
pi remove git:github.com/xz-dev/SuperAgents-skill

Review third-party skills before installation: skills can instruct an agent to use any tools available to it.

Control boundaries

Carry conclusions, exact locators, and the minimum evidence window; keep full diffs, logs, and test output in durable artifacts. Name authority and source precedence, never assume shared memory, and never put credentials or sensitive environment dumps into coordination artifacts. Skills define workflow; the host or tool must enforce isolation, permissions, parameter validation, and output bounds.

Non-goals

This repository is not a port of Superpowers and does not include or prescribe its product workflows. It deliberately omits brainstorming, design workflows, TDD workflows, planning or plan execution, branch-finishing procedures, worktree setup, and any mandatory per-task SDD lifecycle. It also provides no scripts or orchestration runtime.

Attribution and adaptation boundary

This skill pack is informed by coordination practices in obra/superpowers, pinned to v6.2.0, commit 3dcbd5c4b48e02263fbf4a3c01e3fe4f81d584d9.

Only reusable subagent-management techniques were adapted. The source product workflow, sequencing, lifecycle requirements, and source prose were not copied. The files here restate the selected techniques as focused, composable, framework-neutral guidance.

License

Copyright © 2026 xz-dev.

Except where otherwise noted, the original material in this repository is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (license deed).

This repository contains agent instruction material rather than a software runtime. Creative Commons recommends software-specific licenses for software; any software added later should declare its own license explicitly.

About

Framework-neutral skills for delegating, coordinating, handing off, reviewing, and recovering subagent work

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors