do-illo

Generates editorial illustrations with a recurring mascot character across seventeen print-style looks.

2|Updated May 25, 2026
One-click install
npx skills add https://github.com/edheltzel/Do-Skills --skill do-illo-edheltzel
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: do-illo
Source: https://github.com/edheltzel/Do-Skills/tree/main/skills/content/do-illo
Command: npx skills add https://github.com/edheltzel/Do-Skills --skill do-illo-edheltzel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? Written content like blog posts, articles, and social posts often needs original illustrations that explain one idea clearly, but generic image generators produce inconsistent, off-brand results with no recurring character or coherent house style. ## Core Features & Use Cases - Editorial illustration generation: Turn an article, URL, or single concept into flat, print-style scenes where a recurring mascot performs the idea, with explainer diagrams, mini-comics, and transparent character cutouts as alternate registers. - Character packs and styles: Ships with the default mascot Blot and seventeen bundled looks (riso, woodcut, pixel, clay, and more), plus a guided character builder for designing and installing custom mascot packs. - Multiple generation backends: Renders through Codex CLI, Grok CLI, Grok Bot native, or OpenRouter (pay-per-image), with palette management that can derive colors from a site's real CSS. - Use Case: Paste a draft blog post and ask for illustrations; the skill identifies the load-bearing moments, proposes a shot list, and renders a matched set of on-model images in your site's palette. ## Quick Start Say "illo: illustrate this article" with your post or concept attached, and the skill will route the request, pick a character and palette, and generate the illustration.

Frequently Asked Questions about do-illo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate editorial illustrations for a blog post with AI?▼

Invoke the skill by name with your article or concept, for example "illo this post". It routes the source, locks a thesis, proposes a shot list, and renders one image per load-bearing moment using the bundled illo.py engine.

What image generation backends does illo support?▼

It supports Codex CLI and Grok CLI (free for subscribers, drawing on usage quota), Grok Bot's native image tool, and OpenRouter as a paid per-image backend. Backend resolution is capability-aware, and paid fallback after a failed CLI render requires an explicit flag.

Can I create my own mascot character instead of Blot?▼

Yes, the character builder interviews you about the subject, look, and accent, renders model-sheet candidates, and installs the winner as a character pack in ~/.config/illo/characters/. You can keep multiple packs and switch per run by name.

Does illo support transparent PNG cutouts?▼

Yes, the cutout register produces transparent PNGs of the mascot alone for compositing. Codex uses native alpha, while Grok backends cannot produce cutouts since Grok returns JPEG with no alpha, so those requests redirect to a cutout-capable backend.

How much does it cost to generate images with OpenRouter?▼

OpenRouter generation is pay-per-image, typically under ten cents per image, with a typical blog post costing well under a dollar on the default Grok Imagine model. Codex and Grok CLI backends have no per-image charge and draw on subscription quota instead.

Why won't illo trigger on a generic illustrate request?▼

The skill deliberately only activates when directly invoked by name, such as "illo this post", to avoid hijacking generic illustrate or draw requests. Lead with the word illo, then describe characters and ideas freely.