[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6PBSQ58GMBEXNK89MTSJKHD":3,"skill-same:01M6PBSQ58GMBEXNK89MTSJKHD":78},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":38,"linkOnly":39,"markdownContent":40,"markdownBody":41,"frontMatter":42,"refName":27,"commitSha":59,"skillDirectory":60,"forksCount":13,"repositoryHtmlUrl":61,"repositoryHomepageUrl":6,"ownerHtmlUrl":62,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":63,"install":64,"resources":77},"01M6PBSQ58GMBEXNK89MTSJKHD","polis-protocol",null,"Coordinate multi-vendor AI agents as a self-improving team — a learning router assigns work by track record and citizens can amend the protocol's own rules.","duc-duy-1612\u002FOnline-Delivery-Systems-Web","duc-duy-1612","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F192231384?v=4","01M6NSDKQQDKVTHZ8DZMZ1VYY6","01M6NSDKW8DDVTQHBT1HBDDJPT",0,"MIT","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fpolis-protocol\u002FSKILL.md",[],[18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37],"protocol","polis protocol","community","track","collab","self-improving","critical","as","self","main","coordinate","gemini","router","work","multi-agent","coordination","learning","team","orchestration","ai agents","2026-11-10 10:12:30",false,"---\nname: polis-protocol\ndescription: \"Coordinate multi-vendor AI agents as a self-improving team — a learning router assigns work by track record and citizens can amend the protocol's own rules.\"\ncategory: orchestration\nrisk: critical\nsource: community\nsource_repo: yehudalevy-collab\u002Fpolis-protocol\nsource_type: community\ndate_added: \"2026-06-02\"\nauthor: yehudalevy-collab\ntags: [multi-agent, coordination, routing, orchestration, governance, vendor-agnostic]\ntools: [claude, cursor, gemini, codex, antigravity]\nlicense: \"MIT\"\nlicense_source: \"https:\u002F\u002Fgithub.com\u002Fyehudalevy-collab\u002Fpolis-protocol\u002Fblob\u002Fmain\u002FLICENSE\"\nplugin:\n  targets:\n    codex: blocked\n    claude: blocked\n---\n\n# Polis Protocol — a team of agents that develops\n\n## Overview\n\nMost 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\u002F`.\n\nIn 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.\n\n## When to Use This Skill\n\n- Use when 2+ agents (especially across vendors) work on one project and \"who should do this\" is a real question.\n- Use when you want the team to measurably improve over time — routing that adapts from outcomes, not static role labels.\n- Use when you need a durable, git-auditable record of who did what, what was learned, and which rules changed.\n- Use when Antigravity's default orchestration is too rigid and you want routing + governance on top of it.\n\n## How It Works\n\n### Step 1: Found a polis\n\nUse a reviewed checkout by default so the scaffolder code is pinned before it writes into the project:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fyehudalevy-collab\u002Fpolis-protocol.git\ncd polis-protocol\ngit checkout \u003Creviewed-commit-sha>\npython3 scripts\u002Finit_polis.py \\\n  --project-root . \\\n  --agent-id gemini-antigravity-yourproject \\\n  --vendor google --model gemini-3 --tool antigravity\n```\n\nIf you prefer the published PyPI package, install an exact version after reviewing that release, for example `pipx install polis-protocol==\u003Creviewed-version>`. Do not invoke the package through an unpinned `uvx` or \"latest\" workflow for automated setup.\n\nThis writes `_polis\u002F` plus the skill into `.agents\u002Fskills\u002F` (the path Antigravity reads), and bridge pointers (`GEMINI.md`, `AGENTS.md`) that point every tool at `_polis\u002FCONSTITUTION.md`. Tip: add `--dry-run` to preview every file before anything is written; init never overwrites existing files, and `polis init --repair` restores missing ones.\n\n### Step 2: Register citizens and open contracts\n\nEach agent publishes a capability card under `_polis\u002Fcitizens\u002F`. Work is opened as a contract with `required_tags`, not assigned to a fixed role.\n\n### Step 3: Route by track record\n\n```bash\npolis route --polis-root _polis \\\n  --contract _polis\u002Fcontracts\u002Fopen\u002Fyour-task.md --explain\n```\n\nThe router prints a score breakdown (history \u002F self-rating \u002F cost \u002F availability \u002F applied lessons) and recommends the citizen with the strongest record on the task's tags. Agents can also reserve files (`polis reserve src\u002Fauth --as \u003Ccitizen>`) so two agents never edit the same path at once — overlapping claims are rejected with the holder named.\n\n### Step 4: Settle, learn, and amend\n\n```bash\npolis contract settle \u003Ccontract-id> --quality 5\npolis reconcile --polis-root _polis\n```\n\nA settled contract files a lesson; accepted lessons carry a bounded `routing_effect` the router reads — and names in `--explain` — on the next similar task. Failures become guardrails (`polis guardrail add …`) that future contracts on those tags inherit as must-pass acceptance criteria. When a rule stops working, a citizen proposes an amendment and the others vote. Reproduce the learning claim yourself: `polis bench --mode learning`.\n\n## Examples\n\n### Example 1: See the team learn (no install, 30 seconds)\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fyehudalevy-collab\u002Fpolis-protocol.git\ncd polis-protocol\ngit checkout \u003Creviewed-commit-sha>\nbash scripts\u002Fdemo.sh\n```\n\nThe router recommends Gemini for a Spanish-translation contract — because settled work taught it she has the best record on that tag, not because anyone reassigned it.\n\n### Example 2: Explain any routing decision\n\n```bash\npython3 scripts\u002Froute_contract.py --polis-root examples\u002Fresearch-team\u002F_polis \\\n  --contract examples\u002Fresearch-team\u002F_polis\u002Fcontracts\u002Fopen\u002Fparent-newsletter-issue-3.md --explain\n```\n\n## Notes\n\n- No server, no runtime, no database — the whole protocol is markdown plus two small Python scripts.\n- Vendor-agnostic by design; a Claude or Codex agent can join the same polis an Antigravity agent created.\n- Full Antigravity integration guide: https:\u002F\u002Fgithub.com\u002Fyehudalevy-collab\u002Fpolis-protocol\u002Fblob\u002Fmain\u002Fdocs\u002Fantigravity.md\n\n## Limitations\n\n- Routing quality depends on accurate citizen capability cards and enough settled work history to learn from.\n- The protocol coordinates agent work but does not replace review, tests, or explicit maintainer approval.\n- Multi-agent voting and amendments can add process overhead for small, single-owner tasks.\n- The upstream scripts are external code; pin to a reviewed commit and run `--dry-run` before allowing writes to a project.\n","# Polis Protocol — a team of agents that develops\n\n## Overview\n\nMost 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\u002F`.\n\nIn 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.\n\n## When to Use This Skill\n\n- Use when 2+ agents (especially across vendors) work on one project and \"who should do this\" is a real question.\n- Use when you want the team to measurably improve over time — routing that adapts from outcomes, not static role labels.\n- Use when you need a durable, git-auditable record of who did what, what was learned, and which rules changed.\n- Use when Antigravity's default orchestration is too rigid and you want routing + governance on top of it.\n\n## How It Works\n\n### Step 1: Found a polis\n\nUse a reviewed checkout by default so the scaffolder code is pinned before it writes into the project:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fyehudalevy-collab\u002Fpolis-protocol.git\ncd polis-protocol\ngit checkout \u003Creviewed-commit-sha>\npython3 scripts\u002Finit_polis.py \\\n  --project-root . \\\n  --agent-id gemini-antigravity-yourproject \\\n  --vendor google --model gemini-3 --tool antigravity\n```\n\nIf you prefer the published PyPI package, install an exact version after reviewing that release, for example `pipx install polis-protocol==\u003Creviewed-version>`. Do not invoke the package through an unpinned `uvx` or \"latest\" workflow for automated setup.\n\nThis writes `_polis\u002F` plus the skill into `.agents\u002Fskills\u002F` (the path Antigravity reads), and bridge pointers (`GEMINI.md`, `AGENTS.md`) that point every tool at `_polis\u002FCONSTITUTION.md`. Tip: add `--dry-run` to preview every file before anything is written; init never overwrites existing files, and `polis init --repair` restores missing ones.\n\n### Step 2: Register citizens and open contracts\n\nEach agent publishes a capability card under `_polis\u002Fcitizens\u002F`. Work is opened as a contract with `required_tags`, not assigned to a fixed role.\n\n### Step 3: Route by track record\n\n```bash\npolis route --polis-root _polis \\\n  --contract _polis\u002Fcontracts\u002Fopen\u002Fyour-task.md --explain\n```\n\nThe router prints a score breakdown (history \u002F self-rating \u002F cost \u002F availability \u002F applied lessons) and recommends the citizen with the strongest record on the task's tags. Agents can also reserve files (`polis reserve src\u002Fauth --as \u003Ccitizen>`) so two agents never edit the same path at once — overlapping claims are rejected with the holder named.\n\n### Step 4: Settle, learn, and amend\n\n```bash\npolis contract settle \u003Ccontract-id> --quality 5\npolis reconcile --polis-root _polis\n```\n\nA settled contract files a lesson; accepted lessons carry a bounded `routing_effect` the router reads — and names in `--explain` — on the next similar task. Failures become guardrails (`polis guardrail add …`) that future contracts on those tags inherit as must-pass acceptance criteria. When a rule stops working, a citizen proposes an amendment and the others vote. Reproduce the learning claim yourself: `polis bench --mode learning`.\n\n## Examples\n\n### Example 1: See the team learn (no install, 30 seconds)\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fyehudalevy-collab\u002Fpolis-protocol.git\ncd polis-protocol\ngit checkout \u003Creviewed-commit-sha>\nbash scripts\u002Fdemo.sh\n```\n\nThe router recommends Gemini for a Spanish-translation contract — because settled work taught it she has the best record on that tag, not because anyone reassigned it.\n\n### Example 2: Explain any routing decision\n\n```bash\npython3 scripts\u002Froute_contract.py --polis-root examples\u002Fresearch-team\u002F_polis \\\n  --contract examples\u002Fresearch-team\u002F_polis\u002Fcontracts\u002Fopen\u002Fparent-newsletter-issue-3.md --explain\n```\n\n## Notes\n\n- No server, no runtime, no database — the whole protocol is markdown plus two small Python scripts.\n- Vendor-agnostic by design; a Claude or Codex agent can join the same polis an Antigravity agent created.\n- Full Antigravity integration guide: https:\u002F\u002Fgithub.com\u002Fyehudalevy-collab\u002Fpolis-protocol\u002Fblob\u002Fmain\u002Fdocs\u002Fantigravity.md\n\n## Limitations\n\n- Routing quality depends on accurate citizen capability cards and enough settled work history to learn from.\n- The protocol coordinates agent work but does not replace review, tests, or explicit maintainer approval.\n- Multi-agent voting and amendments can add process overhead for small, single-owner tasks.\n- The upstream scripts are external code; pin to a reviewed commit and run `--dry-run` before allowing writes to a project.\n",{"name":5,"risk":24,"tags":43,"tools":47,"author":52,"plugin":53,"source":20,"license":14,"category":36,"date_added":56,"description":7,"source_repo":57,"source_type":20,"license_source":58},[32,33,44,36,45,46],"routing","governance","vendor-agnostic",[48,49,29,50,51],"claude","cursor","codex","antigravity","yehudalevy-collab",{"targets":54},{"codex":55,"claude":55},"blocked","2026-06-02","yehudalevy-collab\u002Fpolis-protocol","https:\u002F\u002Fgithub.com\u002Fyehudalevy-collab\u002Fpolis-protocol\u002Fblob\u002Fmain\u002FLICENSE","f3312ba749561b6159f477dbfc9313c875d40a56",".agents\u002Fskills_archive\u002Fpolis-protocol","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612","2026-10-25 23:50:58",{"source":8,"skillName":5,"commands":65,"prompt":75,"zipAvailable":76},[66,69,72],{"tool":67,"command":68},"npx","npx skills add duc-duy-1612\u002FOnline-Delivery-Systems-Web --skill polis-protocol",{"tool":70,"command":71},"bunx","bunx skills add duc-duy-1612\u002FOnline-Delivery-Systems-Web --skill polis-protocol",{"tool":73,"command":74},"pnpm","pnpm dlx skills add duc-duy-1612\u002FOnline-Delivery-Systems-Web --skill polis-protocol","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fpolis-protocol\u002FSKILL.md",true,[],[79,107,130,154,181,205],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":90,"publishedAt":38},"01M6Q0FA5FZ410Z33Z3TFQ4DBA","zero-trust","Implement zero-trust network architecture. Configure identity-based access, micro-segmentation, and continuous verification. Use when implementing modern security architectures.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fzero-trust\u002FSKILL.md",[85],{"categoryNo":86,"categoryName":87,"taxonomyType":88,"taxonomyTypeDesc":89},"01JBSEEDCAT000000000000011","运维与部署","SCENARIO","使用场景",[91,92,93,94,95,96,81,97,98,99,100,101,20,27,102,24,103,104,105,106],"ZeRO","trust","zero trust","architecture","assessment","verification","segmentation","devops-security","access","configure","only","active","scope","scripts","relevant","implementing",{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":113,"publishedAt":38},"01M6Q0F1YZJW3KX5FBKEVZ8CV4","zcode-delegate","Delegate coding tasks to the Z.AI ZCode CLI only when the user explicitly requests it, while the orchestrator retains review and landing responsibility.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fzcode-delegate\u002FSKILL.md",[],[114,115,116,117,118,36,119,120,121,122,123,124,125,101,126,20,127,128,24,129],"delegate","zcode","zcode delegate","review","cli","tasks","run","Bash","model","node","read","orchestrator","files","desktop app","app","agent-orchestration",{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":136,"publishedAt":38},"01M6Q0ETK41VGNMYEXW0T00AJN","youtube-transcript","Fetch YouTube transcripts through DeepAPI or local fallback tooling and save clean text output.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-transcript\u002FSKILL.md",[],[137,138,139,140,141,50,142,143,144,145,146,147,148,20,27,149,150,151,152,153],"transcript","youtube transcript","youtube","safe","github","research","license","https","text","fetch","tooling","clean","local","output","deepapi","youtube transcripts","blob",{"skillNo":155,"name":156,"nameZh":6,"description":157,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":158,"categories":159,"keywords":171,"publishedAt":38},"01M6Q0EPPH2PVMDW40017F8WX0","youtube-transcript-skills","Fetch YouTube video transcripts, search videos\u002Fchannels, browse channels, and extract playlists via the getyoutubetranscript.com API - free tier, no card required.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-transcript-skills\u002FSKILL.md",[160,163,166],{"categoryNo":161,"categoryName":162,"taxonomyType":88,"taxonomyTypeDesc":89},"01JBSEEDCAT000000000000010","后端与接口",{"categoryNo":164,"categoryName":165,"taxonomyType":88,"taxonomyTypeDesc":89},"01JBSEEDCAT000000000000016","图像与多媒体",{"categoryNo":167,"categoryName":168,"taxonomyType":169,"taxonomyTypeDesc":170},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[137,138,139,172,140,29,141,50,143,173,174,175,176,146,177,20,27,178,179,180],"youtube transcript skills","search","api","Video","browse","api-integration","free","card","channels",{"skillNo":182,"name":183,"nameZh":6,"description":184,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":185,"categories":186,"keywords":191,"publishedAt":38},"01M6Q0EAB96PX83W5PTE8A0R8D","youtube-notetaker","Turn YouTube talks into local study notes with slides, transcripts, editable annotations, and a markdown-backed viewer.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-notetaker\u002FSKILL.md",[187,190],{"categoryNo":188,"categoryName":189,"taxonomyType":88,"taxonomyTypeDesc":89},"01JBSEEDCAT000000000000003","演示文稿",{"categoryNo":164,"categoryName":165,"taxonomyType":88,"taxonomyTypeDesc":89},[139,192,193,118,140,194,195,196,197,143,175,198,199,200,201,27,202,149,203,204],"youtube notetaker","notetaker","workflow","official","notes","code","markdown","slides","annotations","README","study","dair-academy","viewer",{"skillNo":206,"name":207,"nameZh":6,"description":208,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":209,"categories":210,"keywords":212,"publishedAt":38},"01M6Q0E55F0GW5MX48V8HXS8B5","youtube-full","Fetch YouTube transcripts, search videos, browse channels, and extract playlists via TranscriptAPI — no yt-dlp, no Google API key, works from any cloud server.","https:\u002F\u002Fgithub.com\u002Fduc-duy-1612\u002FOnline-Delivery-Systems-Web\u002Fblob\u002Fmain\u002F.agents\u002Fskills_archive\u002Fyoutube-full\u002FSKILL.md",[211],{"categoryNo":161,"categoryName":162,"taxonomyType":88,"taxonomyTypeDesc":89},[213,139,214,215,140,29,173,216,217,174,175,176,146,218,177,20,27,178,219,152],"youtube full","full","google","server","dlp","credits","automatic"]