| name | article-illustrate |
| description | This skill should be used when the user asks to "生成插图", "文章配图", "insert images", "illustrate article", or wants images inserted into an existing article draft. It analyzes article structure, generates matching visuals, and inserts them into markdown. |
| version | 1.0.0 |
Article Illustrate
Use this skill when a markdown article already exists and the next step is to add illustrations into the body.
Use This For
- adding illustrations to a generated article
- converting section headings into image insertion points
- in-place markdown enhancement for article outputs
Do Not Use This For
- creating a cover image
- creating a full article from scratch
- generating unrelated standalone images
Inputs
- article markdown path
- optional style hint
- optional max image count
Outputs
- generated image files under
output/images/
- updated article markdown with inserted
 blocks
- inline images should prefer the same slug family as the source article when possible
Workflow
- Analyze the article for eligible
**bold section** headings.
- Filter out title lines, numbered list-style headings, and empty sections.
- Generate one image prompt per selected section.
- Save generated images to the output directory using the article slug family when possible.
- Insert image markdown below the matching headings.
Fallback Guidance
- If no eligible section headings exist, report that the article is not illustration-ready yet.
- If image generation fails, preserve the article content and return a partial-completion summary.
References
references/insertion-rules.md - article spot detection and insertion behavior
../../docs/overview/article-artifact-family.md - recommended file family for brief, draft, cover, and inline images