Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add skills/ymxlx/polis-protocol/medianpx skills add ymxlx/polis-protocol --skill mediagit clone --depth 1 https://github.com/ymxlx/polis-protocolWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/ymxlx/polis-protocol/media)<a href="https://agentmods.dev/skills/ymxlx/polis-protocol/media"><img src="https://agentmods.dev/badge/skills/ymxlx/polis-protocol/media.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00000 | $0.03728 |
| Opus 5 | $0.00000 | $0.01864 |
| Sonnet 5 | $0.00000 | $0.00746 |
| Haiku 4.5 | $0.00000 | $0.00373 |
Grade A, and why
media scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
This is a copy
100% identical to polis-protocol — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 154 lines — stays where its author put it; the contents beside it link to each section on GitHub.
name: polis-protocol
description: Set up and run a self-improving, multi-vendor AI agent team with the Polis Protocol — a markdown _polis/ folder where each agent is a citizen with a capability card, tasks are contracts routed to whoever has the best track record by a learning router, settled work files lessons that compound into team memory, and citizens can amend the protocol itself. Use whenever several AI agents (any vendor) share one project and "who should do this" is a real question: founding a polis, registering as a citizen, opening/claiming/settling a contract, filing a lesson, running a chavruta review before a high-stakes action, proposing or voting on an amendment, troubleshooting a stalled contract or router pathology, or migrating from agent-vault to add routing. Also triggers on "_polis", "polis", "capability card", "task contract", "chronicle.md", "chavruta", "bandit routing", "agent routing", "cross-vendor coordination", "CONSTITUTION.md" — even when the protocol is not named. For pure note-passing without routing, prefer agent-vault.
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:
- The Register — identity and capability discovery (capability cards).
- The Contract — structured tasks with learned routing.
- The Chronicle — lessons that compound and feed back into routing.
- The Amendment — citizens change the rules when reality demands it.
What ships with it
23 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- init_polis.py 265 B runs code
- polis-mark.svg 872 B
- polis/__init__.py 257 B runs code
- polis/_data/SKILL.md 15 KB
- polis/_data/templates/bridge_pointer.md 1.2 KB
- polis/_data/templates/POLIS_CONSTITUTION.md 14 KB
- polis/_io.py 832 B runs code
- polis/bench.py 10 KB runs code
- polis/cli.py 21 KB runs code
- polis/config.py 2.3 KB runs code
- polis/context.py 4.5 KB runs code
- polis/contracts.py 7.4 KB runs code
- polis/doctor.py 3.4 KB runs code
- polis/guardrails.py 2.3 KB runs code
- polis/initializer.py 19 KB runs code
- polis/integrity.py 2.9 KB runs code
- polis/mcp_server.py 17 KB runs code
- polis/migrate.py 4.6 KB runs code
- polis/report.py 6.6 KB runs code
- polis/reservations.py 4.8 KB runs code
- polis/routing.py 21 KB runs code
- polis/serve.py 6.5 KB runs code
- route_contract.py 261 B runs code
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 154 lines · 0 tokens per session scan A d2e5dcb65906
media is a skill published in the GitHub repository ymxlx/polis-protocol (5 stars, last pushed 2d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 3,728 tokens. A static security scan graded it A with 0 findings. It is 100% identical to polis-protocol, differing in 0 lines, and is treated as a copy.
Other skills, from other repositories
pandic-office
Convert Markdown to PDF (or DOCX/EPUB/HTML) using the pandoc CLI. Use when asked to produce a PDF report, brief, summary, or any document where the input is Markdown and the output should be a polished, paginated file.
audit-onboarding-proposal
Independently audit a brownfield onboarding transcript, operational map, or exact proposed documentation patch before application. Use when a fresh reviewer must verify an $onboard-repository first pass, distinguish environment-caused Unknowns from reasoning defects, score its safety and evidence gates, or run a…
engineering-wisdom
Provide an explicitly requested, repository-grounded engineering review using contextual heuristics for code clarity, SOLID and design, testing, refactoring, architecture, and professional practice. Use only when the user invokes $engineering-wisdom or explicitly asks for this installed engineering-wisdom pack; do not…
proxmox-full
Complete Proxmox VE hypervisor management via REST API - VMs, containers, snapshots, backups, storage.
red-team-adversarial
Adversarial security and resilience analysis — auto-triggered during /review and /test based on task classification. Provides attack surface analysis, boundary testing, auth bypass attempts, dependency chain attacks, and Beast Mode stress testing.
marketing-copy
Write outbound promotional copy for a product or project: launch and update posts for community platforms and social media, store page descriptions and short blurbs, landing page headlines and calls to action, press-style announcements, and the naming of a product for another language or market. Covers what may be…