tentacle-pro Article Illustrator
Analyze articles, identify illustration positions, generate images with Type × Style consistency.
Two Dimensions
| Dimension | Controls | Examples |
|---|---|---|
| Type | Information structure | infographic, scene, flowchart, comparison, framework, timeline |
| Style | Visual aesthetics | notion, warm, minimal, blueprint, watercolor, elegant |
Combine freely: --type infographic --style blueprint
Types
| Type | Best For |
|---|---|
infographic |
Data, metrics, technical |
scene |
Narratives, emotional |
flowchart |
Processes, workflows |
comparison |
Side-by-side, options |
framework |
Models, architecture |
timeline |
History, evolution |
Styles
See references/styles.md for Core Styles, full gallery, and Type × Style compatibility.
Workflow
- [ ] Step 1: Pre-check (source, output dir, references)
- [ ] Step 2: Analyze content
- [ ] Step 3: Confirm settings (AskUserQuestion)
- [ ] Step 4: Generate outline
- [ ] Step 5: Generate images
- [ ] Step 6: Finalize
Step 1: Pre-check
- Confirm source article path or pasted content.
- Create output directory under
Assets/Article-Illustrations/{topic-slug}/. - Ensure
prompts/subdirectory exists before generation. - Load style/type references from
references/.
Full procedures: references/workflow.md
Step 2: Analyze
| Analysis | Output |
|---|---|
| Content type | Technical / Tutorial / Methodology / Narrative |
| Purpose | information / visualization / imagination |
| Core arguments | 2-5 main points |
| Positions | Where illustrations add value |
CRITICAL: Metaphors → visualize underlying concept, NOT literal image.
Full procedures: references/workflow.md
Step 3: Confirm Settings ⚠️
ONE AskUserQuestion, max 4 Qs. Q1-Q3 REQUIRED.
| Q | Options |
|---|---|
| Q1: Type | [Recommended], infographic, scene, flowchart, comparison, framework, timeline, mixed |
| Q2: Density | minimal (1-2), balanced (3-5), per-section (Recommended), rich (6+) |
| Q3: Style | [Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, Other |
| Q4: Language | When source language ≠ user language |
Full procedures: references/workflow.md
Step 4: Generate Outline
Save outline.md with frontmatter (type, density, style, image_count) and entries:
## Illustration 1
**Position**: [section/paragraph]
**Purpose**: [why]
**Visual Content**: [what]
**Filename**: 01-infographic-concept-name.png
Full template: references/workflow.md
Step 5: Generate Images
⛔ BLOCKING: Prompt files MUST be saved before ANY image generation.
For each illustration, create a prompt file per references/prompt-construction.md
Save to
prompts/NN-{type}-{slug}.mdwith YAML frontmatterPrompts MUST use type-specific templates with structured sections (ZONES / LABELS / COLORS / STYLE / ASPECT)
LABELS MUST include article-specific data: actual numbers, terms, metrics, quotes
DO NOT pass ad-hoc inline prompts to
--promptwithout saving prompt files firstEnvironment: ALWAYS rely on
.agents/skills/.envfor model/provider settingsFor each prompt file, generate with unified command:
bun .agents/skills/baoyu-image-gen/scripts/main.ts --promptfiles <output-dir>/prompts/NN-{type}-{slug}.md --image <output-dir>/NN-{type}-{slug}.png --ar 16:9Retry once on failure
Full procedures: references/workflow.md
Step 6: Finalize
Insert  after paragraphs.
Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style]
Images: X/N generated
Output Directory
Assets/Article-Illustrations/{topic-slug}/
├── source-{slug}.{ext}
├── references/ # if provided
├── outline.md
├── prompts/
└── NN-{type}-{slug}.png
Slug: 2-4 words, kebab-case. Conflict: append -YYYYMMDD-HHMMSS.
Modification
| Action | Steps |
|---|---|
| Edit | Update prompt → Regenerate → Update reference |
| Add | Position → Prompt → Generate → Update outline → Insert |
| Delete | Delete files → Remove reference → Update outline |
References
| File | Content |
|---|---|
| references/workflow.md | Detailed procedures |
| references/usage.md | Command syntax |
| references/styles.md | Style gallery |
| references/prompt-construction.md | Prompt templates |