polis-protocol

npx skills add sickn33/agentic-awesome-skills --skill polis-protocol --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Polis Protocol — a team of agents that develops ## Overview Most agent coordination is a passive board: claim a task, do it, mark it done. It records, but it never gets smarter, and its rules are frozen. Polis Protocol is the active alternative — a folder of markdown where each agent is a "citizen" with a capability card, work is routed by a learning bandit to whoever has the best track record on the task's tags, settled work files lessons that update the routing, and citizens can propose and vote on amendments to the protocol itself. It is vendor-agnostic: Antigravity, Claude, Codex, and Gemini agents can all share one `_polis/`. In Antigravity specifically, this turns Manager View's fixed pipeline into a team that learns who is actually best at each kind of work, instead of running the same roles in the same order every time. ## When to Use This Skill - Use when 2+ agents (especially across vendors) work on one project and "who should do this" is a real question. - Use when you want the team to measurably improve over time — routing that adapts from outcomes, not static role labels. - Use when you need a durable, git-auditable record of who did what, what was learned, and which

git clone https://github.com/yehudalevy-collab/polis-protocol.git
cd polis-protocol
git checkout <reviewed-commit-sha>
python3 scripts/init_polis.py \
polis route --polis-root _polis \
polis contract settle <contract-id> --quality 5
polis reconcile --polis-root _polis
bash scripts/demo.sh
python3 scripts/route_contract.py --polis-root examples/research-team/_polis \