Metagit skills#
Metagit ships agent skills (skills/metagit-*/SKILL.md): short playbooks for when and how to use the CLI and MCP. All bundled skills use a metagit- prefix.
New here? Read For AI agents first — install, session start, and context packs.
Install the CLI#
uv tool install metagit-cli
uv tool install -U metagit-cli # upgrade
metagit version
PyPI package name:
metagit-cli(notmetagit).
Install skills#
metagit skills list
metagit skills show metagit-projects
metagit skills install
metagit skills install --scope user --target openclaw --target hermes
metagit skills install --skill metagit-projects --target openclaw
metagit skills install --skill metagit-projects --target openclaw --dry-run
Use --skill (repeatable) to install one or more bundled skills instead of the full set. Omit --skill to install every bundled skill. Add --dry-run to preview targets and paths without writing files.
Optional MCP registration:
metagit mcp install --scope user --target openclaw --target hermes
Other targets: opencode, claude_code, github_copilot.
Skill catalog#
| Skill | Use when |
|---|---|
metagit-cli |
CLI-only agent workflows: all metagit prompt kinds, catalog, detect, sync, layout (no MCP/API) |
metagit-agent-access |
On-demand: optimize any repo for minimal-token agent onboarding (llms.txt, hidden README comments, AGENTS.md) |
metagit-projects |
Starting work; check for existing projects/repos before new folders |
metagit-workspace-scope |
Session start; workspace and sync context |
metagit-control-center |
Ongoing multi-repo coordination |
metagit-workspace-sync |
Guarded fetch/pull/clone |
metagit-config-refresh |
.metagit.yml missing or stale |
metagit-bootstrap |
Generate or refine config with discovery/MCP |
metagit-gating |
MCP workspace gate status |
metagit-upstream-scan |
Search other managed repos for causes |
metagit-upstream-triage |
Rank upstream blockers |
metagit-repo-impact |
Plan cross-repo changes |
metagit-multi-repo |
Implement across several repos |
metagit-gitnexus |
GitNexus index and graph workflows |
metagit-release-audit |
Pre-push / release readiness |
For workspace vs project vs repo definitions, see Terminology.
Source development#
task skills:validate
task skills:sync # mirrors into .cursor/skills/
Update both skills/ and src/metagit/data/skills/ when changing bundled skills.