{"id":"e27bb8cc-f741-4756-b1fb-b7ff52f10d23","shortId":"vUmXb3","kind":"skill","title":"autonomous-common","tagline":"Use when setting up, troubleshooting, or modifying the shared hooks and agent-callable utility scripts that enforce the autonomous dev/review workflow. Triggers on phrases like \"push to main is blocked\", \"block-commit-outside-worktree hook failing\", \"configure hooks after npx ski","description":"# Autonomous Common Infrastructure\n\nShared workflow-enforcement hooks and agent-callable utility scripts used by `autonomous-dev`, `autonomous-review`, and `autonomous-dispatcher`. The other autonomous-* skills reference scripts and hooks here — when those reference paths break, this is usually the skill to look at.\n\n## Setup for `npx skills add` Users\n\nAfter `npx skills add`, run the installer for your coding agent once from the project root:\n\n| Agent | Installer | Writes to |\n|---|---|---|\n| Claude Code | `bash .claude/skills/autonomous-common/scripts/install-claude-hooks.sh` | `.claude/settings.json` |\n| Qoder | `bash .claude/skills/autonomous-common/scripts/install-qoder-hooks.sh` | `.qoder/settings.json` |\n| Antigravity | `bash .claude/skills/autonomous-common/scripts/install-antigravity-hooks.sh` | `.antigravity/hooks.json` |\n| Cursor | `bash .claude/skills/autonomous-common/scripts/install-cursor-hooks.sh` | `.cursor/hooks.json` |\n| Kiro CLI | `bash .claude/skills/autonomous-common/scripts/install-kiro-hooks.sh [--agent <name>]` | `.kiro/agents/<name>.json` (default: `default`) |\n| Gemini CLI | `bash .claude/skills/autonomous-common/scripts/install-gemini-hooks.sh` | `.gemini/settings.json` |\n| Codex CLI | `bash .claude/skills/autonomous-common/scripts/install-codex-hooks.sh` | `.codex/hooks.json` + `.codex/config.toml` |\n| Windsurf | `bash .claude/skills/autonomous-common/scripts/install-windsurf-hooks.sh` | `.windsurf/hooks.json` |\n| Kimi CLI | `bash .claude/skills/autonomous-common/scripts/install-kimi-hooks.sh [--project]` | `~/.kimi/config.toml` (default; `--project` writes `.kimi/config.toml`) |\n\nEach installer wires up the workflow hooks at the **project scope**, so they fire on every shell command in the repo — not only when an autonomous-* skill is explicitly loaded. Without this, the hook commands declared in skill frontmatter only run while a skill is active in the conversation, which is the regression that closed #68.\n\nFor the per-agent schema mapping reference, see [`docs/cross-agent-hooks.md`](https://github.com/zxkane/autonomous-dev-team/blob/main/docs/cross-agent-hooks.md).\n\n### What if you can't run the installer\n\nIf installing into your `.claude/settings.json` is undesirable (shared repo, you want hooks isolated to autonomous-* skills only), the legacy fallback is to symlink the hook directories so the skill-scoped hook commands resolve:\n\n```bash\n# From your project root:\nln -sf .claude/skills/autonomous-common/hooks hooks\nln -sf .claude/skills/autonomous-dispatcher/scripts scripts\n```\n\nThis keeps hooks scoped to the skills' frontmatter (Claude Code only fires them when a skill is active). If the push hook isn't blocking or the commit-outside-worktree check isn't running, check the symlinks — but prefer the installer for full coverage.\n\n### Required Claude Code plugins\n\nClaude Code only. The installer prompts for these; if installing manually, add to `.claude/settings.json` under `enabledPlugins`:\n\n```json\n{\n  \"enabledPlugins\": {\n    \"code-simplifier@claude-plugins-official\": true,\n    \"pr-review-toolkit@claude-plugins-official\": true\n  }\n}\n```\n\n> IDEs without hook support (Cursor, Windsurf, Gemini CLI) skip both the installer and the symlinks — the skills work without hooks, but workflow steps must be followed manually.\n\n## What's here\n\n- **`hooks/`** — workflow-enforcement hooks (block-push-to-main, block-commit-outside-worktree, check-pr-review, check-shellcheck, verify-completion, …). See `hooks/README.md` for the canonical list and per-hook semantics.\n- **`scripts/`** — agent-callable utilities used by the dev/review skills:\n  - `lib-installer.sh` — shared merge/write helpers used by every per-agent installer\n  - `lib-installer-translate.sh` — schema translation helpers for near-clone agents (event-name map, tool-name map, timeout-unit conversion)\n  - `install-claude-hooks.sh` — Claude Code installer (writes `.claude/settings.json`)\n  - `install-qoder-hooks.sh` — Qoder installer (writes `.qoder/settings.json` — same schema as Claude Code)\n  - `install-antigravity-hooks.sh` — Antigravity installer (writes `.antigravity/hooks.json` — hooks-only file; contract is community-observed, undocumented by Google)\n  - `install-cursor-hooks.sh` — Cursor installer (writes `.cursor/hooks.json` — `version: 1` envelope, camelCase events, `Shell` matcher)\n  - `install-kiro-hooks.sh` — Kiro CLI / Amazon Q installer (writes `.kiro/agents/<name>.json` — agent definition with camelCase events, `execute_bash`/`fs_write` matchers, `timeout_ms` in milliseconds)\n  - `install-gemini-hooks.sh` — Gemini CLI installer (writes `.gemini/settings.json` — `BeforeTool`/`AfterTool` events, `run_shell_command`/`write_file`/`replace` matchers)\n  - `install-codex-hooks.sh` — Codex CLI installer (writes `.codex/hooks.json` + sets `[features] codex_hooks = true` in `.codex/config.toml`)\n  - `install-windsurf-hooks.sh` — Windsurf installer (writes `.windsurf/hooks.json` — snake_case events that fold matcher info; no per-tool matcher field)\n  - `install-kimi-hooks.sh` — Kimi CLI installer (writes `~/.kimi/config.toml` user-level by default, or `.kimi/config.toml` with `--project`; emits TOML `[[hooks]]` blocks)\n  - `claude-settings.template.json` — canonical hook list applied by all per-agent installers\n  - `gh-as-user.sh` — runs `gh` as a real user (needed when retriggering bot reviews like `/q review`)\n  - `mark-issue-checkbox.sh` — toggles GitHub issue body checkboxes from the agent\n  - `reply-to-comments.sh` — replies to PR review comments\n  - `resolve-threads.sh` — batch-resolves review threads on a PR\n\n> The hooks and scripts are documented in detail in their respective README/source files. This SKILL.md only catalogs what's available so you can find the right file to edit.","tags":["autonomous","common","dev","team","zxkane","agent-skills","ai-agents","ai-code-review","amazon-q-developer","autonomous-coding","claude-code","claude-code-action"],"capabilities":["skill","source-zxkane","skill-autonomous-common","topic-agent-skills","topic-ai-agents","topic-ai-code-review","topic-amazon-q-developer","topic-autonomous-coding","topic-claude-code","topic-claude-code-action","topic-claude-code-hooks","topic-code-review-automation","topic-code-review-bots","topic-codex","topic-codex-cli"],"categories":["autonomous-dev-team"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/zxkane/autonomous-dev-team/autonomous-common","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add zxkane/autonomous-dev-team","source_repo":"https://github.com/zxkane/autonomous-dev-team","install_from":"skills.sh"}},"qualityScore":"0.458","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 17 github stars · SKILL.md body (5,776 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:06:10.234Z","embedding":null,"createdAt":"2026-04-19T00:40:44.290Z","updatedAt":"2026-05-18T19:06:10.234Z","lastSeenAt":"2026-05-18T19:06:10.234Z","tsv":"'/.kimi/config.toml':167,608 '/q':646 '/zxkane/autonomous-dev-team/blob/main/docs/cross-agent-hooks.md).':240 '1':527 '68':227 'activ':217,313 'add':99,104,356 'aftertool':563 'agent':16,57,111,117,142,232,448,465,475,542,631,656 'agent-cal':15,56,447 'amazon':536 'antigrav':130,505 'antigravity/hooks.json':133,508 'appli':626 'autonom':2,23,47,64,67,71,75,197,263 'autonomous-common':1 'autonomous-dev':63 'autonomous-dispatch':70 'autonomous-review':66 'avail':691 'bash':123,127,131,135,140,149,154,159,164,283,548 'batch':665 'batch-resolv':664 'beforetool':562 'block':34,36,320,416,421,621 'block-commit-outside-worktre':35,420 'block-push-to-main':415 'bodi':652 'bot':643 'break':86 'callabl':17,58,449 'camelcas':529,545 'canon':439,623 'case':591 'catalog':688 'check':327,331,426,430 'check-pr-review':425 'check-shellcheck':429 'checkbox':653 'claud':121,304,342,345,367,376,489,502 'claude-plugins-offici':366,375 'claude-settings.template.json':622 'claude/settings.json':125,253,358,493 'claude/skills/autonomous-common/hooks':290 'claude/skills/autonomous-common/scripts/install-antigravity-hooks.sh':132 'claude/skills/autonomous-common/scripts/install-claude-hooks.sh':124 'claude/skills/autonomous-common/scripts/install-codex-hooks.sh':155 'claude/skills/autonomous-common/scripts/install-cursor-hooks.sh':136 'claude/skills/autonomous-common/scripts/install-gemini-hooks.sh':150 'claude/skills/autonomous-common/scripts/install-kimi-hooks.sh':165 'claude/skills/autonomous-common/scripts/install-kiro-hooks.sh':141 'claude/skills/autonomous-common/scripts/install-qoder-hooks.sh':128 'claude/skills/autonomous-common/scripts/install-windsurf-hooks.sh':160 'claude/skills/autonomous-dispatcher/scripts':294 'cli':139,148,153,163,387,535,558,574,605 'clone':474 'close':226 'code':110,122,305,343,346,364,490,503 'code-simplifi':363 'codex':152,573,580 'codex/config.toml':157,584 'codex/hooks.json':156,577 'command':189,206,281,567 'comment':662 'commit':37,324,422 'commit-outside-worktre':323 'common':3,48 'communiti':516 'community-observ':515 'complet':434 'configur':42 'contract':513 'convers':220,487 'coverag':340 'cursor':134,384,522 'cursor/hooks.json':137,525 'declar':207 'default':145,146,168,613 'definit':543 'detail':679 'dev':65 'dev/review':24,454 'directori':274 'dispatch':72 'docs/cross-agent-hooks.md':237 'document':677 'edit':700 'emit':618 'enabledplugin':360,362 'enforc':21,53,413 'envelop':528 'event':477,530,546,564,592 'event-nam':476 'everi':187,462 'execut':547 'explicit':200 'fail':41 'fallback':268 'featur':579 'field':602 'file':512,569,684,698 'find':695 'fire':185,307 'fold':594 'follow':405 'frontmatt':210,303 'fs':549 'full':339 'gemini':147,386,557 'gemini/settings.json':151,561 'gh':635 'gh-as-user.sh':633 'github':650 'github.com':239 'github.com/zxkane/autonomous-dev-team/blob/main/docs/cross-agent-hooks.md).':238 'googl':520 'helper':459,470 'hook':13,40,43,54,80,178,205,260,273,280,291,298,317,382,399,410,414,444,510,581,620,624,673 'hooks-on':509 'hooks/readme.md':436 'ide':380 'info':596 'infrastructur':49 'instal':107,118,173,248,250,337,349,354,391,466,491,496,506,523,538,559,575,587,606,632 'install-antigravity-hooks.sh':504 'install-claude-hooks.sh':488 'install-codex-hooks.sh':572 'install-cursor-hooks.sh':521 'install-gemini-hooks.sh':556 'install-kimi-hooks.sh':603 'install-kiro-hooks.sh':533 'install-qoder-hooks.sh':494 'install-windsurf-hooks.sh':585 'isn':318,328 'isol':261 'issu':651 'json':144,361,541 'keep':297 'kimi':162,604 'kimi/config.toml':171,615 'kiro':138,534 'kiro/agents':143,540 'legaci':267 'level':611 'lib-installer-translate.sh':467 'lib-installer.sh':456 'like':29,645 'list':440,625 'ln':288,292 'load':201 'look':93 'main':32,419 'manual':355,406 'map':234,479,483 'mark-issue-checkbox.sh':648 'matcher':532,551,571,595,601 'merge/write':458 'millisecond':555 'modifi':10 'ms':553 'must':403 'name':478,482 'near':473 'near-clon':472 'need':640 'npx':45,97,102 'observ':517 'offici':369,378 'outsid':38,325,423 'path':85 'per':231,443,464,599,630 'per-ag':230,463,629 'per-hook':442 'per-tool':598 'phrase':28 'plugin':344,368,377 'pr':372,427,660,671 'pr-review-toolkit':371 'prefer':335 'project':115,166,169,181,286,617 'prompt':350 'push':30,316,417 'q':537 'qoder':126,495 'qoder/settings.json':129,498 'readme/source':683 'real':638 'refer':77,84,235 'regress':224 'replac':570 'repli':658 'reply-to-comments.sh':657 'repo':192,257 'requir':341 'resolv':282,666 'resolve-threads.sh':663 'respect':682 'retrigg':642 'review':68,373,428,644,647,661,667 'right':697 'root':116,287 'run':105,212,246,330,565,634 'schema':233,468,500 'scope':182,279,299 'script':19,60,78,295,446,675 'see':236,435 'semant':445 'set':6,578 'setup':95 'sf':289,293 'share':12,50,256,457 'shell':188,531,566 'shellcheck':431 'simplifi':365 'ski':46 'skill':76,91,98,103,198,209,215,264,278,302,311,396,455 'skill-autonomous-common' 'skill-scop':277 'skill.md':686 'skip':388 'snake':590 'source-zxkane' 'step':402 'support':383 'symlink':271,333,394 'thread':668 'timeout':485,552 'timeout-unit':484 'toggl':649 'toml':619 'tool':481,600 'tool-nam':480 'toolkit':374 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-code-review' 'topic-amazon-q-developer' 'topic-autonomous-coding' 'topic-claude-code' 'topic-claude-code-action' 'topic-claude-code-hooks' 'topic-code-review-automation' 'topic-code-review-bots' 'topic-codex' 'topic-codex-cli' 'translat':469 'trigger':26 'troubleshoot':8 'true':370,379,582 'undesir':255 'undocu':518 'unit':486 'use':4,61,451,460 'user':100,610,639 'user-level':609 'usual':89 'util':18,59,450 'verifi':433 'verify-complet':432 'version':526 'want':259 'windsurf':158,385,586 'windsurf/hooks.json':161,589 'wire':174 'without':202,381,398 'work':397 'workflow':25,52,177,401,412 'workflow-enforc':51,411 'worktre':39,326,424 'write':119,170,492,497,507,524,539,550,560,568,576,588,607","prices":[{"id":"ab217257-4d81-4d35-b26f-a855dade9234","listingId":"e27bb8cc-f741-4756-b1fb-b7ff52f10d23","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"zxkane","category":"autonomous-dev-team","install_from":"skills.sh"},"createdAt":"2026-04-19T00:40:44.290Z"}],"sources":[{"listingId":"e27bb8cc-f741-4756-b1fb-b7ff52f10d23","source":"github","sourceId":"zxkane/autonomous-dev-team/autonomous-common","sourceUrl":"https://github.com/zxkane/autonomous-dev-team/tree/main/skills/autonomous-common","isPrimary":false,"firstSeenAt":"2026-04-19T00:40:44.290Z","lastSeenAt":"2026-05-18T19:06:10.234Z"}],"details":{"listingId":"e27bb8cc-f741-4756-b1fb-b7ff52f10d23","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"zxkane","slug":"autonomous-common","github":{"repo":"zxkane/autonomous-dev-team","stars":17,"topics":["agent-skills","ai-agents","ai-code-review","amazon-q-developer","autonomous-coding","claude-code","claude-code-action","claude-code-hooks","code-review-automation","code-review-bots","codex","codex-cli","coding-agents","github-automation","github-issues","kiro-cli","llm-agents","openclaw","pull-request-automation","tdd"],"license":null,"html_url":"https://github.com/zxkane/autonomous-dev-team","pushed_at":"2026-05-18T16:25:24Z","description":"Turns GitHub issues into merged PRs with zero human intervention. Powered by OpenClaw, supports Claude Code, Codex CLI, and Kiro CLI.","skill_md_sha":"ec3f2c48add207badc0ee445638073071910bbda","skill_md_path":"skills/autonomous-common/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/zxkane/autonomous-dev-team/tree/main/skills/autonomous-common"},"layout":"multi","source":"github","category":"autonomous-dev-team","frontmatter":{"name":"autonomous-common","description":"Use when setting up, troubleshooting, or modifying the shared hooks and agent-callable utility scripts that enforce the autonomous dev/review workflow. Triggers on phrases like \"push to main is blocked\", \"block-commit-outside-worktree hook failing\", \"configure hooks after npx skills add\", \"what does check-pr-review.sh do\", \"set up workflow hook symlinks\", or when editing files under `skills/autonomous-common/`. Provides the hooks the autonomous-dev / autonomous-review skills depend on, plus utility scripts (gh-as-user.sh, mark-issue-checkbox.sh, reply-to-comments.sh, resolve-threads.sh)."},"skills_sh_url":"https://skills.sh/zxkane/autonomous-dev-team/autonomous-common"},"updatedAt":"2026-05-18T19:06:10.234Z"}}