{"id":50896542,"url":"https://github.com/tmchow/illo-skill","last_synced_at":"2026-06-19T04:00:34.227Z","repository":{"id":364360765,"uuid":"1267521793","full_name":"tmchow/illo-skill","owner":"tmchow","description":"illo — an AI agent skill that turns ideas and articles into original print-style editorial illustrations, starring a recurring mascot. Ten bundled looks, custom characters, OpenRouter-powered.","archived":false,"fork":false,"pushed_at":"2026-06-17T16:46:45.000Z","size":16532,"stargazers_count":164,"open_issues_count":0,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-18T03:26:03.772Z","etag":null,"topics":["agent-skills","claude-code","illustration","image-generation","skill"],"latest_commit_sha":null,"homepage":"https://illo-skill.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tmchow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-12T16:03:22.000Z","updated_at":"2026-06-18T02:34:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tmchow/illo-skill","commit_stats":null,"previous_names":["tmchow/illo-skill"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/tmchow/illo-skill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmchow%2Fillo-skill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmchow%2Fillo-skill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmchow%2Fillo-skill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmchow%2Fillo-skill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tmchow","download_url":"https://codeload.github.com/tmchow/illo-skill/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tmchow%2Fillo-skill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34516549,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-19T02:00:06.005Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","claude-code","illustration","image-generation","skill"],"created_at":"2026-06-16T01:00:23.589Z","updated_at":"2026-06-19T04:00:34.208Z","avatar_url":"https://github.com/tmchow.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"_assets/illo/logo/illo-logo.png\" alt=\"illo logo — a small screen-faced robot with a pink antenna\" width=\"170\" /\u003e\n\u003c/p\u003e\n\n# illo\n\nGenerate original print-style **editorial illustrations** for articles and\nblogs, starring a recurring mascot that performs each idea. Each character\npack carries one of ten bundled looks (riso, blueprint, woodcut, pixel, clay,\nmanila, chalk, phosphor, enamel, gouache) or a custom style — default\n**Blot** (a deadpan ink-drop), or design your own with the built-in character\nbuilder. One-metaphor-per-image scenes with named + custom + derived palettes\nand reference-image character consistency. Renders through **two backends**:\nyour **Codex CLI** (gpt-image-2 on your Codex subscription — free for\nsubscribers, no API key) when one is installed and logged in, or\n**OpenRouter** (model-selectable: Grok Imagine, Nano Banana 2/Pro, GPT-5.4\nImage 2, …) as the universal fallback.\n\nHand it *\"we replatform with zero downtime\"* and you get the bridge being\nrebuilt under live traffic:\n\n![Zero downtime — rebuilding the bridge under live traffic](_assets/illo/05-bridgeswap-ink-punch.png)\n\n\u003e **🌐 [illo-skill.com](https://illo-skill.com)** — live examples, the\n\u003e character gallery, and copy-paste installs.\n\nThe skill itself lives in [`skills/illo/`](skills/illo/) — its\n[README](skills/illo/README.md) is the full developer reference\n(prerequisites, API-key setup, models \u0026 cost, everything below in detail).\n\nSame idea, different voice — four of the ten bundled looks:\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"_assets/illo/02-funnel-ink-punch.png\" alt=\"riso look\" /\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"_assets/illo/styles/clay-rootcause.png\" alt=\"clay look\" /\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eriso\u003c/strong\u003e — the house default\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eclay\u003c/strong\u003e — stop-motion plasticine\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"_assets/illo/styles/phosphor-spike.png\" alt=\"phosphor look\" /\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"_assets/illo/styles/blueprint-crossing.png\" alt=\"blueprint look\" /\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003ephosphor\u003c/strong\u003e — CRT trace on glass\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cstrong\u003eblueprint\u003c/strong\u003e — draftsman linework\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Install\n\n**Quick install — any agent.** One command for Claude Code, Cursor, Codex,\nCopilot, Gemini CLI, and the ~70 other runtimes the\n[skills CLI](https://skills.sh) supports (update later with\n`npx skills update`):\n\n```bash\nnpx skills add tmchow/illo-skill --skill illo\n```\n\n**Platform-native installs.** The repo also ships a plugin/extension\nmanifest for each major runtime, so you can install through your platform's\nown package manager and get managed updates:\n\n| Platform | Install | Update |\n| --- | --- | --- |\n| **Claude Code** | `/plugin marketplace add tmchow/illo-skill` then `/plugin install illo@illo-skill` | `claude plugin update illo`, or enable marketplace auto-update |\n| **Codex** | `codex plugin marketplace add tmchow/illo-skill` then `codex plugin add illo@illo-skill` | `codex plugin marketplace upgrade` |\n| **Gemini CLI** | `gemini extensions install https://github.com/tmchow/illo-skill` | `gemini extensions update illo` |\n| **Copilot / GitHub CLI** | `gh skill install tmchow/illo-skill illo` (cross-agent via `--agent`) | `gh skill update illo` |\n| **Cursor** | `npx skills add tmchow/illo-skill --skill illo` (Cursor Marketplace listing pending review) | re-run the installer |\n| **Hermes** | `hermes skills install tmchow/illo-skill/illo` | `hermes skills update illo` |\n| **OpenClaw** | `openclaw skills install illo` | reinstall with the same command |\n\nEvery lane installs the same skill; releases are tagged `v\u003cversion\u003e` and\nthe version in every manifest is kept in lockstep with\n`skills/illo/SKILL.md` by CI.\n\n## Repo layout\n\nThe skill sits in `skills/illo/`, following the layout of the canonical\nskill repos (anthropics/skills, openai/skills): a top-level `skills/`\nfolder, one directory per skill. It is deliberately not at the repo root —\ninstallers copy the entire skill directory verbatim, so the skill dir holds\nonly what every install should ship. Docs-only images live in\n`_assets/illo/` (linked by raw URL), and repo meta stays at the root —\nincluding the plugin manifests (`.claude-plugin/`, `.codex-plugin/`,\n`.cursor-plugin/`, `gemini-extension.json`) that make the repo installable\nas a native plugin on each platform.\n\n## Companion repos\n\n- [tmchow/illo-characters](https://github.com/tmchow/illo-characters) —\n  community character packs (\"install the blip character\").\n\n## Provenance\n\nillo started life inside\n[tmchow/agent-skills](https://github.com/tmchow/agent-skills); it moved here\nwith full git history. The old location keeps a frozen copy so existing\ninstalls don't break, but this repo is the canonical home — new versions\nship only from here.\n\n## License\n\nMIT © Trevin Chow — see [`LICENSE`](LICENSE) and\n[`skills/illo/NOTICE`](skills/illo/NOTICE) for attribution of the Blot character and\nbundled artwork.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmchow%2Fillo-skill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftmchow%2Fillo-skill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftmchow%2Fillo-skill/lists"}