polis-protocol-a-self-optimizing-city-of-agents
Polis Protocol: A Self-Optimizing City of Agents
Profile →npx skills add sickn33/agentic-awesome-skills --skill polis-protocol-a-self-optimizing-city-of-agents --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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 constitu
- When to Use
- The core idea
- When this skill is active
- Structure of a polis
- The first thing to do every session
- The chronicle: recording what you did
- The Register: capability cards
- The Contract: structured tasks with learned routing
- Chavruta review for high-stakes contracts
- The Amendment: a polis that updates itself
- Founding a polis
- Registering a citizen into an existing polis
- Working across vendors
- Failure modes and recovery
What does the polis-protocol-a-self-optimizing-city-of-agents skill do?
Polis Protocol: A Self-Optimizing City of Agents
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill polis-protocol-a-self-optimizing-city-of-agents --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.