Koo Docs
View as Markdown

AI skills

Coming soon

Koo ships installable skills for Claude Code, Codex, and Cursor. A skill teaches your coding agent the Koo deploy flow over the MCP server's tools — call koo_whoami, pick or create a service, deploy, follow the deployment timeline until the service is ready, and report the live URL — with the guardrails built in.

The skills are code-complete and generated from one canonical manifest in the Koo monorepo, but they install alongside the @koo-io/mcp-server package, which is not published to npm yet. The command below is what will install them.

Installation is one command per agent — it registers the MCP server and writes the matching skill:

text
koo mcp install <host>   # claude-code | codex | cursor

Each host gets the skill in its native shape: a Claude Code skill (SKILL.md), a Cursor project rule (.cursor/rules/koo.mdc, written only inside a git repository), or a marker-delimited block appended to Codex's AGENTS.md. koo mcp uninstall <host> removes exactly what was added.

What the skill enforces

  • Authority from the API. The skill never invents quotas, roles, or retention windows — it reads them back as API errors and acts on the hint (re-mint with a larger role, upgrade the plan, stop retrying).
  • Tools and the CLI only. It drives the koo_* tools and the koo CLI, never a raw HTTP request to the API.
  • No token ever printed. It never writes or echoes a kc_… token; the token lives in your OS keyring, injected for the server by the launcher. With no token, the skill tells you to run koo mcp install rather than failing opaquely.
  • Source builds via the CLI. The MCP tools deploy prebuilt images; for a local-source build the skill has you run koo up, then watches the result with the tools.

Until then