illo-skill

illo skill developer resources

This page is the developer index for illo skill (illo-skill.com). It exists so agents and search engines that look up “illo-skill” developer resources, API docs, auth, webhooks, or MCP can see what the product actually exposes.

What you integrate with

illo skill is an Agent Skills package. You install SKILL.md plus illo.py from github.com/tmchow/illo-skill and run it in a coding agent. This origin publishes a read-only catalog so agents can list packs. It does not generate images, take accounts, or accept webhooks.

Surface	Status	Where
Agent skill (`SKILL.md` + `illo.py`)	Supported	github.com/tmchow/illo-skill
Character pack catalog	Supported	/characters.json and /api/characters
OpenAPI 3.1	Supported	/openapi.json
Catalog MCP (Streamable HTTP)	Supported — lookup only	/mcp, /server.json, /.well-known/mcp
CLI	The skill engine	/cli.json points at `illo.py` — no npm API client
Image / render HTTP API	None	Rendering stays in the installed skill
Auth / OAuth / accounts	None	OpenRouter keys stay on the user's machine
Webhooks / GraphQL / commerce	None	Not product surfaces on this origin

Do not invent render URLs such as https://illo-skill.com/api/render. Missing paths return HTTP 404 — HTML or Markdown for browsers and agents, or a JSON problem (code, message, hint) when you send Accept: application/json or hit /api/*.

How an agent should call illo skill

Install with this host's native plugin or skill manager: Claude Code, Codex, Grok CLI, Grok Bot, Gemini CLI, Copilot (gh skill install), Hermes, OpenClaw, Cursor. npx skills add is last resort. Full table: llms.txt and the GitHub README.
Confirm an image backend: Codex CLI, Grok CLI, Grok Bot, or illo.py init for OpenRouter.
Invoke with /illo … or matching natural language.
Install character packs by name from the JSON catalog when needed.

Machine-readable files

/openapi.json
/characters.json
/llms.txt
/agent-instructions.md
/cli.json
/mcp — Streamable HTTP MCP (catalog tools only)
/server.json and /mcp/server-card
/.well-known/api-catalog (RFC 9727)
/sitemap.xml
/index.md and .md twins for every content page

Markdown content negotiation: send Accept: text/markdown to a page URL, or fetch the .md sibling. Responses set Content-Type: text/markdown; charset=utf-8 and Vary: Accept, Accept-Encoding.