article-illustratorWhen the user wants to add illustrations to an article or blog post. Triggers on: "illustrate article", "add images to article", "generate illustrations", "article images", or requests to visually enhance written content. Analyzes article structure, identifies positions for visual aids, and generates illustrations using a Type x Style two-dimension approach.
Install via ClawdBot CLI:
clawdbot install wpank/article-illustratorAnalyze articles, identify optimal illustration positions, and generate images using a Type x Style consistency system.
npx clawhub@latest install article-illustrator
| Dimension | Controls | Examples |
|-----------|----------|----------|
| Type | Information structure, layout | infographic, scene, flowchart, comparison, framework, timeline |
| Style | Visual aesthetics, mood | notion, warm, minimal, blueprint, watercolor, elegant, editorial, scientific |
Types and styles combine freely: --type infographic --style blueprint
| Type | Best For |
|------|----------|
| infographic | Data, metrics, technical articles |
| scene | Narratives, personal stories, emotional content |
| flowchart | Tutorials, workflows, processes |
| comparison | Side-by-side, before/after, options |
| framework | Methodologies, models, architecture |
| timeline | History, progress, evolution |
| Style | Best For |
|-------|----------|
| notion (Default) | Knowledge sharing, SaaS, productivity |
| elegant | Business, thought leadership |
| warm | Personal growth, lifestyle, education |
| minimal | Philosophy, core concepts |
| blueprint | Architecture, system design |
| watercolor | Lifestyle, travel, creative |
| editorial | Tech explainers, journalism |
| scientific | Academic, technical research |
Full style specs and compatibility matrix: references/styles.md
| Content Signals | Type | Style |
|-----------------|------|-------|
| API, metrics, data, numbers | infographic | blueprint, notion |
| Story, emotion, journey | scene | warm, watercolor |
| How-to, steps, workflow | flowchart | notion, minimal |
| vs, pros/cons, before/after | comparison | notion, elegant |
| Framework, model, architecture | framework | blueprint, notion |
| History, timeline, progress | timeline | elegant, warm |
{article-dir}/ — same directory{article-dir}/illustrations/ — illustrations subdirectory (recommended)illustrations/{topic-slug}/ — independent directory{name}-illustrated.md copy| Analysis | Description |
|----------|-------------|
| Content type | Technical / Tutorial / Methodology / Narrative |
| Core arguments | 2-5 main points to visualize |
| Visual opportunities | Positions where illustrations add value |
| Recommended type | Based on content signals |
| Recommended density | Based on length and complexity |
Illustrate: core arguments (required), abstract concepts, data comparisons, processes/workflows.
Skip: literal metaphors, decorative scenes, generic illustrations.
Use a structured question with 3-4 questions in ONE call:
Save as outline.md with YAML frontmatter (type, density, style, count) and per-illustration details: position, purpose, visual content, filename.
prompts/illustration-{slug}.mdInsert image references after corresponding paragraphs:

Output a summary with article path, settings, image count, and positions.
illustrations/{topic-slug}/
├── source-{slug}.{ext}
├── outline.md
├── prompts/
│ └── illustration-{slug}.md
└── NN-{type}-{slug}.png
Good illustration prompts must include:
Avoid: vague descriptions, literal metaphor illustrations, missing labels, generic decorative elements.
Full templates by type: references/prompt-construction.md
| | notion | warm | minimal | blueprint | watercolor | elegant | editorial | scientific |
|---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| infographic | ++ | + | ++ | ++ | + | ++ | ++ | ++ |
| scene | + | ++ | + | - | ++ | + | + | - |
| flowchart | ++ | + | + | ++ | - | + | ++ | + |
| comparison | ++ | + | ++ | + | + | ++ | ++ | + |
| framework | ++ | + | ++ | ++ | - | ++ | + | ++ |
| timeline | ++ | + | + | + | ++ | ++ | ++ | + |
++ highly recommended | + compatible | - not recommended
# Auto-select type and style
illustrate path/to/article.md
# Specify type
illustrate path/to/article.md --type infographic
# Specify type and style
illustrate path/to/article.md --type flowchart --style notion
# Specify density
illustrate path/to/article.md --density rich
Custom configurations via EXTEND.md files:
.article-illustrator/EXTEND.md$HOME/.config/article-illustrator/EXTEND.mdSupports: watermark, preferred type/style, custom styles, language, output directory.
| Action | Steps |
|--------|-------|
| Edit | Update prompt, regenerate, update reference |
| Add | Identify position, create prompt, generate, update outline, insert |
| Delete | Delete files, remove reference, update outline |
| File | Content |
|------|---------|
| references/usage.md | Command syntax, options, input modes |
| references/styles.md | Style gallery, compatibility matrix, auto-selection |
| references/prompt-construction.md | Prompt templates for each illustration type |
| references/styles/