Article To Illustrations
Turn a reviewed long-form draft into an illustrated Markdown delivery artifact while preserving the article's argument, evidence, and human approval gates.
Use this skill for illustrations anchored inside a long-form body. Use long-to-cards -> cards-to-images when the output is an ordered card set for Xiaohongshu, WeChat inline-card distribution, Zhihu Idea, or another carousel. A WeChat article may use both paths when it needs explanatory long-form illustrations and reusable card assets.
Inputs
Collect:
- reviewed source Markdown or a near-final draft
- target platforms
- fact and review status
- visual style or brand constraints, if available
- current platform image requirements or user-specified ratios
- available local images, screenshots, diagrams, or source assets
- existing
content_state
Route back to content review when the article's thesis or structure is still changing. Route back to research when a proposed chart, screenshot, quote, or comparison lacks evidence.
Workflow
1. Decide Whether Each Platform Needs Illustrations
Assign one decision per target platform:
| Decision |
Use when |
required |
A central workflow, mechanism, comparison, evidence screenshot, or dense checklist is difficult to understand from prose alone. |
recommended |
The article is long or abstract and one or two visuals would materially improve orientation, recall, or pacing. |
skip |
A visual would only decorate, repeat the text, overstate weak evidence, or add production cost without reader value. |
Explain the decision in one sentence. Do not add images just to satisfy a fixed count.
2. Build Platform-specific Image Slots
For every accepted slot, record:
- stable image id
- target platform
- insertion anchor: heading plus a short nearby text anchor
- reader purpose: hook, mechanism, evidence, comparison, checklist, transition, or CTA
- image type: diagram, screenshot, annotated screenshot, chart, illustration, or text card
- source anchor and factual constraints
- aspect ratio and dimensions based on reviewed requirements
- visual direction and generation or rendering prompt
- alt text
- status:
planned, approved, generated, inserted, or rejected
Reuse the concept, evidence, and visual system across platforms when useful. Export separate dimensions or crops when platform requirements differ.
3. Pause At The Image-plan Gate
Show the complete plan before generating multiple images, using paid services, editing supplied screenshots, or creating assets that could be mistaken for evidence.
Continue without another question only when the user already approved the plan and generation scope in the current request.
4. Generate Or Accept Local Images
Use the available image generation, diagram, screenshot, or rendering capability that matches the slot. Save outputs inside the reviewed project or case directory.
Check every image for:
- factual alignment with the source
- readable text and labels
- consistent visual language
- correct platform dimensions
- absence of invented UI, metrics, quotes, logos, or outcomes
Label conceptual visuals as illustrations. Keep screenshots and charts traceable to their sources.
5. Insert Relative Markdown References
Insert each approved local image after its recorded anchor. Use descriptive alt text and relative paths.
Do not duplicate the whole article merely to carry metadata. Keep one formal body file per platform and store plans and manifests separately.
6. Produce The Image Manifest
For each inserted image, record:
- image id and platform
- target Markdown file
- local relative path
- insertion anchor
- alt text
- source or
conceptual-illustration
- dimensions
- checksum when available
- R2 state:
not_planned, planned, confirmed, uploaded, or verified
7. Hand Off To md-img-r2
Run md-img-r2 in plan mode against the illustrated Markdown first. Review missing files, object keys, predicted public URLs, and replacements.
Require explicit confirmation before upload or Markdown rewrite. After an approved apply run, verify public URLs and route to wenchang-publish-check in final mode.
Output Format
# Illustration Delivery
## Platform Decisions
| Platform | Decision | Reason | Planned images |
| --- | --- | --- | --- |
## Illustration Plan
### IMG-01
- Platform:
- Insertion anchor:
- Reader purpose:
- Image type:
- Source anchor:
- Factual constraints:
- Ratio and dimensions:
- Visual direction:
- Generation prompt:
- Alt text:
- Status:
## Inserted Files
- Markdown file:
- Local images:
## Image Manifest
| ID | Platform | Markdown | Local path | Source | Dimensions | R2 state |
| --- | --- | --- | --- | --- | --- | --- |
## Handoff
- Next skill: md-img-r2 / wenchang-publish-check
- User confirmation needed:
- Blockers:
Update only compact pointers and statuses in content_state; keep full copy in the referenced artifacts.
Boundaries
- Do not replace the card pipeline when the requested output is an ordered multi-card package.
- Do not invent evidence, product interfaces, metrics, quotations, or outcomes.
- Do not generate decorative images that add no reader value.
- Do not upload images, rewrite Markdown with public URLs, or publish externally without explicit confirmation.
- Do not expose private paths, credentials, account details, or unreleased assets.
- Stop when an image source is missing, the target platform requirement is uncertain and materially affects production, or the planned image could mislead readers.
作者入口
1---2name: article-to-illustrations3description: Plan, generate, insert, and hand off evidence-safe illustrations for reviewed long-form Markdown articles. Use when a WeChat, Zhihu, blog, or other long-form draft needs an illustration decision, image slots, generation prompts, local image insertion, alt text, an image manifest, or a safe handoff to md-img-r2 before publishing. Follow/关注作者:微信公众号「AI生命克劳德」|X @yangchao228|GitHub https://github.com/yangchao2284version: 1.0.05metadata:6 source: https://skillmd.com/skills/yangchao228/article-to-illustrations7 openclaw:8 homepage: https://github.com/yangchao228/my_open_skills/tree/main/skills/content/article-to-illustrations9---1011# Article To Illustrations1213Turn a reviewed long-form draft into an illustrated Markdown delivery artifact while preserving the article's argument, evidence, and human approval gates.1415Use this skill for illustrations anchored inside a long-form body. Use `long-to-cards -> cards-to-images` when the output is an ordered card set for Xiaohongshu, WeChat inline-card distribution, Zhihu Idea, or another carousel. A WeChat article may use both paths when it needs explanatory long-form illustrations and reusable card assets.1617## Inputs1819Collect:2021- reviewed source Markdown or a near-final draft22- target platforms23- fact and review status24- visual style or brand constraints, if available25- current platform image requirements or user-specified ratios26- available local images, screenshots, diagrams, or source assets27- existing `content_state`2829Route back to content review when the article's thesis or structure is still changing. Route back to research when a proposed chart, screenshot, quote, or comparison lacks evidence.3031## Workflow3233### 1. Decide Whether Each Platform Needs Illustrations3435Assign one decision per target platform:3637| Decision | Use when |38| --- | --- |39| `required` | A central workflow, mechanism, comparison, evidence screenshot, or dense checklist is difficult to understand from prose alone. |40| `recommended` | The article is long or abstract and one or two visuals would materially improve orientation, recall, or pacing. |41| `skip` | A visual would only decorate, repeat the text, overstate weak evidence, or add production cost without reader value. |4243Explain the decision in one sentence. Do not add images just to satisfy a fixed count.4445### 2. Build Platform-specific Image Slots4647For every accepted slot, record:4849- stable image id50- target platform51- insertion anchor: heading plus a short nearby text anchor52- reader purpose: hook, mechanism, evidence, comparison, checklist, transition, or CTA53- image type: diagram, screenshot, annotated screenshot, chart, illustration, or text card54- source anchor and factual constraints55- aspect ratio and dimensions based on reviewed requirements56- visual direction and generation or rendering prompt57- alt text58- status: `planned`, `approved`, `generated`, `inserted`, or `rejected`5960Reuse the concept, evidence, and visual system across platforms when useful. Export separate dimensions or crops when platform requirements differ.6162### 3. Pause At The Image-plan Gate6364Show the complete plan before generating multiple images, using paid services, editing supplied screenshots, or creating assets that could be mistaken for evidence.6566Continue without another question only when the user already approved the plan and generation scope in the current request.6768### 4. Generate Or Accept Local Images6970Use the available image generation, diagram, screenshot, or rendering capability that matches the slot. Save outputs inside the reviewed project or case directory.7172Check every image for:7374- factual alignment with the source75- readable text and labels76- consistent visual language77- correct platform dimensions78- absence of invented UI, metrics, quotes, logos, or outcomes7980Label conceptual visuals as illustrations. Keep screenshots and charts traceable to their sources.8182### 5. Insert Relative Markdown References8384Insert each approved local image after its recorded anchor. Use descriptive alt text and relative paths.8586Do not duplicate the whole article merely to carry metadata. Keep one formal body file per platform and store plans and manifests separately.8788### 6. Produce The Image Manifest8990For each inserted image, record:9192- image id and platform93- target Markdown file94- local relative path95- insertion anchor96- alt text97- source or `conceptual-illustration`98- dimensions99- checksum when available100- R2 state: `not_planned`, `planned`, `confirmed`, `uploaded`, or `verified`101102### 7. Hand Off To `md-img-r2`103104Run `md-img-r2` in plan mode against the illustrated Markdown first. Review missing files, object keys, predicted public URLs, and replacements.105106Require explicit confirmation before upload or Markdown rewrite. After an approved apply run, verify public URLs and route to `wenchang-publish-check` in `final` mode.107108## Output Format109110```markdown111# Illustration Delivery112113## Platform Decisions114| Platform | Decision | Reason | Planned images |115| --- | --- | --- | --- |116117## Illustration Plan118### IMG-01119- Platform:120- Insertion anchor:121- Reader purpose:122- Image type:123- Source anchor:124- Factual constraints:125- Ratio and dimensions:126- Visual direction:127- Generation prompt:128- Alt text:129- Status:130131## Inserted Files132- Markdown file:133- Local images:134135## Image Manifest136| ID | Platform | Markdown | Local path | Source | Dimensions | R2 state |137| --- | --- | --- | --- | --- | --- | --- |138139## Handoff140- Next skill: md-img-r2 / wenchang-publish-check141- User confirmation needed:142- Blockers:143```144145Update only compact pointers and statuses in `content_state`; keep full copy in the referenced artifacts.146147## Boundaries148149- Do not replace the card pipeline when the requested output is an ordered multi-card package.150- Do not invent evidence, product interfaces, metrics, quotations, or outcomes.151- Do not generate decorative images that add no reader value.152- Do not upload images, rewrite Markdown with public URLs, or publish externally without explicit confirmation.153- Do not expose private paths, credentials, account details, or unreleased assets.154- Stop when an image source is missing, the target platform requirement is uncertain and materially affects production, or the planned image could mislead readers.155156## 作者入口157158- 微信公众号:`AI生命克劳德`159- X:[@yangchao228](https://x.com/yangchao228)160- GitHub:[yangchao228](https://github.com/yangchao228)