How do I install the Metagit Aos skill?

Run npx skillmds@latest add metagit-ai/metagit-aos in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Metagit Aos safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Metagit Aos?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Metagit Aos free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Metagit Aos?

metagit-ai (@metagit-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Metagit Aos by metagit-ai — Agent Skill

Name: Metagit Aos
Author: metagit-ai

Metagit Aos

Compose ACL, task graph, scheduler, merge, and related coordination subsystems via metagit aos|coord status|doctor|next. Use when an operator or orchestrator needs one snapshot of coordination health or the next work envelope without launching models. Start with the day-1 quickstart for the canonical control loop.

metagit-ai Updated Sep 17, 2026

File contents

Metagit Agent Operating System (AOS)

Use when you need a composed view of coordination state, or a preview of what should run next across ACL + task graph + optional 0009–0012.

Day-1 control loop (start here): docs/agents-quickstart.md

Full reference: docs/reference/aos.md Run ledger: docs/reference/run-ledger.md

Minimal practice workspace: examples/agent-aos-loop/

Control loop

export METAGIT_AGENT_MODE=true

metagit context pack --tier 2 --json
metagit prompt workspace --kind session-start --text-only

metagit aos status --json
metagit aos doctor --json
metagit aos next --json                 # preview (no schedule record)
metagit aos next --commit --json        # record schedule decision
# then compile / ACL / work / complete / merge enqueue as separate steps
metagit context compile --project P --repo R --task-id NODE --json
metagit aos next --apply-hints --agent-id agent-1 --json   # ACL APIs only
metagit task complete --node-id NODE --json

Alias: metagit coord … is identical to metagit aos ….

Rules

Doctor --fix requires --yes and only runs lease expire-on-list + worktree gc.
next --apply-hints never launches models and never runs compile.
Prefer aos next preview before --commit when exploring.

ACL primitives: skill metagit-agent-coordination
Scheduler alone: metagit schedule next
Quickstart: docs/agents-quickstart.md

---name: metagit-aosdescription: Compose ACL, task graph, scheduler, merge, and related coordination subsystems via metagit aos|coord status|doctor|next. Use when an operator or orchestrator needs one snapshot of coordination health or the next work envelope without launching models. Start with the day-1 quickstart for the canonical control loop.---# Metagit Agent Operating System (AOS)Use when you need a **composed** view of coordination state, or a preview ofwhat should run next across ACL + task graph + optional 0009–0012.**Day-1 control loop (start here):**[docs/agents-quickstart.md](../../../../docs/agents-quickstart.md)Full reference: [docs/reference/aos.md](../../../../docs/reference/aos.md)Run ledger: [docs/reference/run-ledger.md](../../../../docs/reference/run-ledger.md)Minimal practice workspace: [examples/agent-aos-loop/](../../../../examples/agent-aos-loop/)## Control loop```bashexport METAGIT_AGENT_MODE=truemetagit context pack --tier 2 --jsonmetagit prompt workspace --kind session-start --text-onlymetagit aos status --jsonmetagit aos doctor --jsonmetagit aos next --json # preview (no schedule record)metagit aos next --commit --json # record schedule decision# then compile / ACL / work / complete / merge enqueue as separate stepsmetagit context compile --project P --repo R --task-id NODE --jsonmetagit aos next --apply-hints --agent-id agent-1 --json # ACL APIs onlymetagit task complete --node-id NODE --json```Alias: `metagit coord …` is identical to `metagit aos …`.## Rules- Doctor `--fix` requires `--yes` and only runs lease expire-on-list + worktree gc.- `next --apply-hints` never launches models and never runs compile.- Prefer `aos next` preview before `--commit` when exploring.## Related- ACL primitives: skill `metagit-agent-coordination`- Scheduler alone: `metagit schedule next`- Quickstart: `docs/agents-quickstart.md`

Frequently asked questions