- name
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 i
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add JimLiu/baoyu-skills --skill baoyu-article-illustrator -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add JimLiu/baoyu-skills --skill baoyu-article-illustrator -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add JimLiu/baoyu-skills --skill baoyu-article-illustrator -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add JimLiu/baoyu-skills --skill baoyu-article-illustrator -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/JimLiu/baoyu-skills/tree/HEAD/skills/baoyu-article-illustratorFrom the publisher
When this skill prompts the user, follow this tool-selection rule (priority order):
AskUserQuestion, request_user_input, clarify, ask_user, or any equivalent.Concrete AskUserQuestion references below are examples — substitute the local equivalent in other runtimes.
Resolve the image backend in this order:
preferred_image_backend in EXTEND.md names a backend available now → use it. ask means ask every run.auto, unset, or the pinned backend is unavailable), first match wins:
imagegen skill is in your available skills → you are in Codex and MUST use it: Skill with skill: "imagegen", passing the prompt file's content plus output path and aspect ratio. It outranks non-native skills such as baoyu-image-gen.codex exec (codex-imagegen): no native imagegen, but the codex CLI is on PATH with an active codex 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.GenerateImage → use it (outranks non-native skills). It has no aspect-ratio parameter, so state the aspect ratio / dimensions in the description prompt; 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 in reference_image_paths.image_generate) → use it the same way.baoyu-image-gen) → use it.⛔ 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.
After every prompt file for the run has been saved and verified, generate images in batches by default:
generation_batch_size images at a time (default 4). An explicit request in the current message (--batch-size 4, "并行4张一起生成") overrides EXTEND.md.Default: confirm before generation.
EXTEND.md defaults are recommendation inputs only — none authorizes skipping confirmation.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).
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.
- [ ] 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.
1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING — first match wins:
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.
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.
Hard gate per the Confirmation Policy. ONE AskUserQuestion, max 4 Qs. Q1-Q2 required; Q3 required unless a preset was chosen.
See workflow.md.
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.
⛔ Prompt files MUST be saved before ANY image generation, whatever the backend.
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 --prompt without saving prompt files first.## Image Generation Tools. For codex-imagegen, see references/codex-imagegen.md.direct/style/palette) per prompt frontmatter; apply watermark if EXTEND.md enables it.## Batch Generation Policy; retry once on failure.See workflow.md.
Insert  after the corresponding paragraph (path relative to the article file, per Output Directory), then print the completion summary (workflow.md).
Set by default_output_dir in EXTEND.md:
{output-dir}/
├── outline.md
├── prompts/
│ └── NN-{type}-{slug}.md
└── NN-{type}-{slug}.png
Pasted content (no file path) always uses illustrations/{topic-slug}/ with source-{slug}.{ext} saved alongside. Slug: 2-4 words, kebab-case. Conflict: append -YYYYMMDD-HHMMSS.
Text correction: never patch misspelled, garbled, or weak rendered text in the bitmap with code. Write a new prompt file and a new output path so the flawed candidate is kept for comparison. Post-processing is limited to crop, resize, compression, or format conversion that doesn't alter text or composition.
EXTEND.md lives at the first matching path in Step 1.5. Edit it directly (schema: references/config/preferences-schema.md), or delete it / ask "reconfigure baoyu-article-illustrator preferences" / "重新配置" to re-run first-time setup. Common edits:
preferred_image_backend: auto (default; runtime-native wins, else the only installed backend, ask if multiple non-native) | codex-imagegen | baoyu-image-gen | ask (confirm every run)generation_batch_size: 4 — concurrent renders when parallel calls are supportedpreferred_type: infographic, preferred_style: notion, preferred_palette: macaron, language: zhdefault_output_dir: imgs-subdir© 2026 Skills Rack.
---name: baoyu-article-illustratordescription: Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type ×…---# skills/baoyu-article-illustrator/SKILL.mdOverview
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 "为文章配图".
FAQ
Download skills/baoyu-article-illustrator/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/JimLiu/baoyu-skills.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.