Polis Protocol

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 hi

5 stars 4 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add ymxlx/polis-protocol --skill polis-protocol

Manual install

git clone --depth 1 https://github.com/ymxlx/polis-protocol.git /tmp/polis-protocol
mkdir -p ~/.claude/skills
cp -r /tmp/polis-protocol/. ~/.claude/skills/polis-protocol

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 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

Read the full skill on GitHub

Details

Skill name: polis-protocol
Repository: ymxlx/polis-protocol
License: MIT
Repo updated: 25 October 2026

FAQ

What does the Polis Protocol skill do?

How do I install the Polis Protocol skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add ymxlx/polis-protocol --skill polis-protocol. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Polis Protocol popular?

It lives in ymxlx/polis-protocol, which has 5 GitHub stars and 4 forks.

Related skills

Engineering Intelligence

devravik/engineering-intelligence

Senior engineering quality control for Antigravity agents (detect, attribute, prioritize, repair, verify).

AI, LLMs & Agents

MCP Sprawl Audit

karanb192/mcp-sprawl-audit

Audit MCP server sprawl on this machine for Claude Code, Codex CLI and Grok CLI. Counts how many copies of each MCP server the running agent sessions hold, what they cost in memory, which ones are duplicates, unused, unpinned or bundled in plugins, and which can run as one shared HTTP copy instead. Use when the machine is slow with many agent sessions open, when someone asks how much memory MCP servers use, or before adding more MCP servers. Read-only; it writes a plan and changes nothing.

AI, LLMs & Agents

AI Citation Auditor

madrank8/ai-citation-auditor

Audit any page to predict whether AI search engines (Google AI Overviews and AI Mode, ChatGPT, Perplexity, Gemini, Claude) will cite it, then return a prioritized fix list. Scores 6 dependency-free layers gated by a retrieval-rank prerequisite: answer-first extractability, evidence corroboration, consensus alignment, source-quality fingerprint, SEO-slop detection, and machine structure. Runs on native web fetch and search or on pasted content, with no paid APIs, connectors, or crawlers required. Two modes: AUDIT (URL or draft in, scored scorecard plus fixes out) and REWRITE (turn one section i

AI, LLMs & Agents

Tomorrowdao Agent Skills

TomorrowDAOProject/tomorrowDAO-skill

TomorrowDAO governance, BP, and resource operations for agents.

AI, LLMs & Agents

AI Slop Cleaner En Ru

tuwulalo/ai-slop-cleaner-en-ru

Detect and clean AI-generated text ("AI slop"), bilingual EN + RU. Use to rewrite AI clichés, "it's not just X, it's Y", "delve", "under the hood", "важно отметить", "под капотом", the rule of three, into natural human prose, or to check whether text was written by a neural network / ChatGPT and rate its "AI-likeness". Detects the text's register first (official / press / blog / forum) and rewrites within it: no slang in a formal post, no officialese in a casual one. Tells decorative AI emoji (🚀💡✅ markers) from genuine human emoji. Двуязычный детектор и чистильщик ИИ-текста: проверить, напис

AI, LLMs & Agents

Staff Engineer

johngbl/staff-engineer

Pragmatic Senior Engineering Skill. Transforms coding agents into Staff-level pragmatic engineers via evidence-based verified loops (TDD + linter + review), anti-guessing discipline, greppable Clean Code, and workspace sandboxing. XP with AI — simple by default, ceremony only when earned. Self-contained, no external files required.

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.