The AI-Skill

The CLI carries an AI-Skill: an Agent Skills bundle (SKILL.md and its references) that teaches a coding agent the CLI, the product grammar, the generators, and the rules and error codes. It is rendered from the same catalogs as this site's reference, by the very binary you run, so it always describes the CLI you have.

Installing it

aircloud skill install --agent claude
aircloud skill install --detect --prompt
aircloud skill install --dir ./.claude/skills

--agent installs for one agent; --detect installs for every supported agent found on the machine, and with --prompt asks before each. The skill is written to the agent's user skills directory, from any directory, with no session and no network:

--dir writes the skill under another root instead, for an unlisted agent or a project. Installing also registers the dev MCP server with the agent as a user-scope stdio entry (command aircloud, arguments mcp); it pre-approves no tool. --with-mcp=false skips the registration.

The CLI never overwrites a directory it did not write. A copy it wrote follows the aircloud installation that wrote it: when that installation's build changes — after aircloud upgrade, or after a downgrade — it re-renders the copy on its next run. Any other aircloud (a second installation on your PATH, a build you run from a checkout) leaves the copy as it is and tells you so; aircloud skill install --agent <agent> makes the copy follow the aircloud you run it with.

Reading and checking it

aircloud skill show
aircloud skill doctor

skill show prints the skill's SKILL.md. skill doctor checks that your region speaks the contracts this CLI was built for and that every installed copy of the skill is this CLI's; it exits 0 only when both hold, and names each domain or copy that differs. A difference means the CLI, the skill or the region is a different build: upgrade the CLI and reinstall the skill.