Agent skill · product strategy · sickn33
polis-protocol-a-self-optimizing-city-of-agents
Polis Protocol: A Self-Optimizing City of Agents
Why this skill is useful
Provides a comprehensive protocol for multi-agent collaboration that includes executable workflows and structures for self-optimization not found in standard practices.
What it needs
About 8k tokens when loaded. Last updated 2026-08-07. 44,571 stars on the source repository.
What this skill does
Bundled upstream support Supporting files are included at skill-relative paths. See UPSTREAM-NOTICE.md for their pinned sources, licenses, hashes, and import changes. Polis Protocol: A Self-Optimizing City of Agents When to Use Use this skill when you need polis Protocol: A Self-Optimizing City of Agents. A protocol that lets AI agents from different vendors collaborate on a long-running project, route work to whoever is best at it, and get measurably better over time. Everything lives in a folder of markdown files, so any tool that reads and writes text can participate — no central server, no required runtime. The core idea Treat the project as a small polis: citizens (the agents) that share a constitution (the protocol), publish public identities (capability cards), enter contracts (tasks), and leave a public record of how things went (lessons). Three institutions plus a self-change mechanism: 1. The Register — identity and capability discovery (capability cards). 2. The Contract — structured tasks with learned routing. 3. The Chronicle — lessons that compound and feed back into routing. 4. The Amendment — citizens change the rules when reality demands it. This buys what shared-vault setups don't: cross-vendor optimization (work goes to whoever is best at it), self-development (routing improves with use), and constitutional evolution (the protocol updates itself from friction). For pure note-passing without routing, prefer agent-vault. When this skill is active Any multi-agent scenario where "who should do this" is a real question: founding or joining a polis; writing, claiming, or settling a contract; running a chavruta review; proposing or ratifying an amendment; or diagnosing a stalled contract, sync conflict, router pathology, or stuck quorum. Upgrading from agent-vault → references/troubleshooting.md ("Migrating from agent-vault"). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sickn33/polis-protocol-a-self-optimizing-city-of-agents--8deb39