AI agent that reads articles and generates relevant images to improve visual storytelling.
Install
mkdir -p .claude/skills/baoyu-article-illustrator && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1550" && unzip -o skill.zip -d .claude/skills/baoyu-article-illustrator && rm skill.zipInstalls to .claude/skills/baoyu-article-illustrator
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type × Style × Palette three-dimension approach. Use when user asks to "illustrate article", "add images", "generate images for article", or "为文章配图".Key capabilities
- →Map article content to visual illustration opportunities
- →Apply 3-dimension consistency (Type, Style, Palette)
- →Automate visual asset placement
- →Sync with project-specific image backends
How it works
Parses article structure to identify key concepts, then applies consistent parameter rules (Type × Style × Palette) to generate images.
Inputs & outputs
When to use baoyu-article-illustrator
- →Illustrate a long-form article
- →Generate images for blog content
- →Create thematic visuals for a technical post
- →Add images to markdown documentation
About this skill
Article Illustrator
User Input Tools
When this skill prompts the user, follow this tool-selection rule (priority order):
- Prefer built-in user-input tools exposed by the current agent runtime — e.g.,
AskUserQuestion,request_user_input,clarify,ask_user, or any equivalent. - Fallback: if no such tool exists, emit a numbered plain-text message and ask the user to reply with the chosen number/answer for each question.
- Batching: if the tool supports multiple questions per call, combine all applicable questions into a single call; if only single-question, ask them one at a time in priority order.
Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes.
Image Generation Tools
Resolve the image backend in this order:
- User names a backend in the current message → use it.
preferred_image_backendinEXTEND.mdnames a backend available now → use it.askmeans ask every run.- Auto-select (preference
auto, unset, or the pinned backend is unavailable), first match wins:- Codex
imagegenskill is in your available skills → you are in Codex and MUST use it:Skillwithskill: "imagegen", passing the prompt file's content plus output path and aspect ratio. It outranks non-native skills such asbaoyu-image-gen. - Codex via
codex exec(codex-imagegen): no nativeimagegen, but thecodexCLI is onPATHwith an activecodex login→baoyu-image-gen --provider codex-cli(preferred), or the bundled wrapper if baoyu-image-gen is unavailable. Load references/codex-imagegen.md only for this branch. - Cursor
GenerateImage→ use it (outranks non-native skills). It has no aspect-ratio parameter, so state the aspect ratio / dimensions in thedescriptionprompt; it saves to a tool-managed location, so copy the file to the expected output path (e.g.,outputs/.../NN-xxx.png). Reference images go inreference_image_paths. - Other runtime-native image tool (e.g., Hermes
image_generate) → use it the same way. - Exactly one non-native backend installed (e.g.,
baoyu-image-gen) → use it. - Several non-native backends → ask the user once, batched with other initial questions.
- Codex
- None available → tell the user and ask how to proceed.
⛔ Raster only: never substitute SVG, HTML/CSS, canvas, or other code-based rendering for a raster image, even for diagram-like content. If no raster backend resolves, go to step 4.
⛔ No bitmap text patching: never use ImageMagick, Pillow, Canvas, SVG, HTML/CSS, OCR scripts, or any other overlay to cover, rewrite, erase, stroke, or replace labels, captions, or any other text inside an already generated illustration. Regenerate from a corrected prompt, redraw with less or no on-image text, or ask the user which imperfect candidate to keep.
Prompt file (hard): before invoking any backend, write each image's full, final prompt to its own file under prompts/ (NN-{type}-[slug].md) and pass that file (or its content) to the backend. It is the reproducibility record and lets you switch backends without rewriting prompts.
Change the pinned backend via ## Changing Preferences below. Tool names above are examples; use the local equivalent in other runtimes.
Batch Generation Policy
After every prompt file for the run has been saved and verified, generate images in batches by default:
- Use the chosen backend's native batch / multi-task interface if it exists. Each task keeps its own prompt file, output path, aspect ratio, and direct reference images.
- Otherwise, if the runtime can issue parallel tool calls, dispatch up to
generation_batch_sizeimages at a time (default4). An explicit request in the current message (--batch-size 4, "并行4张一起生成") overrides EXTEND.md. - Otherwise generate sequentially.
- Never start a batch until all its prompt files exist on disk.
- Retry failed items once without regenerating successful ones.
- Don't use subagents just to parallelize rendering; only for separate per-image prompt iteration or creative exploration.
Confirmation Policy
Default: confirm before generation.
- Explicit skill invocation, a file path, matched signals/presets, and
EXTEND.mddefaults are recommendation inputs only — none authorizes skipping confirmation. - Do not start Step 4 or later until the user completes Step 3.
- Skip confirmation only when the current request explicitly says so ("直接生成", "不用确认", "跳过确认", "按默认出图", or equivalent). Then state the assumed type / density / style / palette / language / backend in the next user-facing update before generating.
Reference Images
Users may supply refs via --ref <files...>, file paths, or pasted images; they guide style, palette, composition, or subject. Step 1.0 in references/workflow.md saves them to references/NN-ref-{slug}.{ext}; Step 5.3 processes per-illustration usage direct | style | palette. When the backend supports batch input, propagate direct entries from each prompt file's references: frontmatter into its batch task (e.g. baoyu-image-gen accepts ref per task).
Three Dimensions
| Dimension | Controls | Values |
|---|---|---|
| Type | Information structure | infographic (data, metrics, technical), scene (narrative, emotional), flowchart (processes), comparison (side-by-side), framework (models, architecture), timeline (history, evolution) |
| Style | Rendering approach | See references/styles.md (Core Styles, gallery, Type × Style compatibility) |
| Palette | Color scheme (optional) | macaron, warm, neon — overrides style's default colors |
Combine freely (--type infographic --style vector-illustration --palette macaron) or use --preset edu-visual for type + style + palette in one flag (references/style-presets.md). Command syntax and options: references/usage.md.
Workflow
- [ ] Step 1: Pre-check (EXTEND.md, references, config)
- [ ] Step 2: Analyze content
- [ ] Step 3: Confirm settings (AskUserQuestion)
- [ ] Step 4: Generate outline
- [ ] Step 5: Generate images
- [ ] Step 6: Finalize
Detailed procedures for every step: references/workflow.md.
Step 1: Pre-check
1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING — first match wins:
| Priority | Path | Scope |
|---|---|---|
| 1 | .baoyu-skills/baoyu-article-illustrator/EXTEND.md | Project |
| 2 | ${XDG_CONFIG_HOME:-$HOME/.config}/baoyu-skills/baoyu-article-illustrator/EXTEND.md | XDG |
| 3 | $HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md | User home |
Found → read, parse, display summary. Not found → ⛔ run first-time-setup before anything else.
Also: save reference images (1.0), determine input type and output dir (1.1–1.4). See workflow.md.
Step 2: Analyze
Determine content type (Technical / Tutorial / Methodology / Narrative), purpose (information / visualization / imagination), 2-5 core arguments, and positions where illustrations add value. Metaphors → visualize the underlying concept, never the literal image. See workflow.md.
Step 3: Confirm Settings ⚠️
Hard gate per the Confirmation Policy. ONE AskUserQuestion, max 4 Qs. Q1-Q2 required; Q3 required unless a preset was chosen.
| Q | Options |
|---|---|
| Q1: Preset or Type | [Recommended preset], [alt preset], or manual: 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, poster, Other — skip if preset chosen |
| Q4: Palette | Default (style colors), macaron, warm, neon — skip if preset includes palette or preferred_palette set |
| Q5: Language | When article language ≠ EXTEND.md setting |
See workflow.md.
Step 4: Generate Outline
Save outline.md with frontmatter (type, density, style, palette, image_count) and one entry per illustration (Position, Purpose, Visual Content, Filename 01-infographic-concept-name.png). Template: workflow.md.
Step 5: Generate Images
⛔ Prompt files MUST be saved before ANY image generation, whatever the backend.
- Per illustration, write
prompts/NN-{type}-{slug}.md(YAML frontmatter) per references/prompt-construction.md: type-specific template with ZONES / LABELS / COLORS / STYLE / ASPECT; LABELS use article-specific data (actual numbers, terms, metrics, quotes). Never pass ad-hoc inline prompts to--promptwithout saving prompt files first. - Select the backend once per session via
## Image Generation Tools. Forcodex-imagegen, see references/codex-imagegen.md. - Process references (
direct/style/palette) per prompt frontmatter; apply watermark if EXTEND.md enables it. - Generate from saved prompt files per
## Batch Generation Policy; retry once on failure.
See workflow.md.
Step 6: Finalize
Insert  after the corresponding paragraph (path relative to the article file, per Output Directory), then print the completion summary (workflow.md).
Output Directory
Set by default_output_dir in EXTEND.md:
default_output_dir | Output Path | Markdown Insert Path |
|---|---|---|
imgs-subdir (default) | {article-dir}/imgs/ | `imgs/NN-{ |
Content truncated.
When not to use it
- →For highly abstract creative projects without specific article structure
- →When strict brand-specific manual graphic design is required
Prerequisites
Limitations
- →Depends on the capabilities of the underlying image generator
- →Relies on prompt interpretation for stylistic accuracy
How it compares
Ensures visual consistency across an entire document rather than generating one-off images in isolation.
Compared to similar skills
baoyu-article-illustrator side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| baoyu-article-illustrator (this skill) | 18 | 5mo | No flags | Beginner |
| baoyu-cover-image | 10 | 5mo | No flags | Beginner |
| video-ai-direction | 0 | 5mo | Review | Intermediate |
| comic-studio-workflow | 0 | 5mo | No flags | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by JimLiu
View all by JimLiu →You might also like
baoyu-cover-image
JimLiu
Generates article cover images with 5 dimensions (type, palette, rendering, text, mood) combining 9 color palettes and 6 rendering styles. Supports cinematic (2.35:1), widescreen (16:9), and square (1:1) aspects. Use when user asks to "generate cover image", "create article cover", or "make cover".
video-ai-direction
cardinalconseils
AI video generation direction for Kling API — prompt engineering, motion design, platform specs, text-to-video and image-to-video workflows for marketing content
comic-studio-workflow
yantianqi1
Use when the user wants to create a comic/manga from a story, premise, or prompt. Executes the full pipeline: story analysis, character design, storyboard planning, image prompt composition, and image generation. Produces final comic page images as output.
imagen
Anhvu1107
ALWAYS use this when the request matches Imagen: AI image generation skill powered by Google Gemini, enabling seamless visual content creation for UI placeholders, documentation, and design assets.
social-media
langchain-ai
Use this skill when creating short-form social media content for LinkedIn, Twitter/X, or other platforms
jimeng-mcp-skill
wwwzhouhui
使用jimeng-mcp-server进行AI图像和视频生成。当用户请求从文本生成图像、合成多张图片、从文本描述创建视频或为静态图像添加动画时使用此技能。支持四大核心能力:文生图、图像合成、文生视频、图生视频。需要jimeng-mcp-server在本地运行或通过SSE/HTTP访问。