Image Illustration and Upload

Professional capability for automatically generating illustrations for official account articles, uploading to image hosting, and inserting Markdown links.

When to Use This Skill

Automatically load this skill when detecting the following scenarios:

User says "generate illustration now", "help me create illustrations", "add images"
Illustration needs are mentioned after article review is completed
Article content is complete but lacks images

Core Features

Analyze Illustration Requirements: Determine 5-8 illustrations needed based on article content
Obtain Image Sources:
- Public domain works (Wikimedia Commons, Google Arts & Culture)
- AI-generated images (Volcano Engine doubao-seedream API)
- Free image libraries (Unsplash, Pexels)
Auto-upload to Image Hosting: Call ImgBB image hosting to get permanent links
Insert into Markdown: Insert image links at corresponding positions in the article
Validation & Display: Ensure all image links are valid

Illustration Quantity Specifications

Recommended: 5-8 images
Minimum: 3 images (cover image + 2 body images)
Maximum: No more than 10 images (avoid excessive reading interruption)

Illustration Placement Strategy

Mandatory Placements:

✅ Cover image: Below the title, required
✅ Core chapters: 1 image per key chapter

Optional Placements:

Theoretical support (e.g., citing classic works)
Data visualization (comparison charts, graphs)
Case supplements (product screenshots, examples)

Image Source Priority

1️⃣ Public Domain Works (Highest Priority)

Sources: Wikimedia Commons, Google Arts & Culture
Applicable: Classic artworks, historical portraits, ancient book covers
Advantages: Free, no copyright issues, high quality
Examples: Van Gogh's Starry Night, portrait of Kant
Operation: Use WebFetch to get Wikimedia Commons image links

2️⃣ AI Generation (Recommended)

Source: Volcano Engine doubao-seedream-4-0-250828
Applicable: Cover images, concept maps, abstract themes
Advantages: Original, customizable, fast
Operation: Call API to generate images and return temporary URLs

3️⃣ Free Image Libraries

Sources: Unsplash, Pexels, Pixabay
Applicable: Cover images, concept maps, background images
Advantages: Free, high quality, commercially usable (CC0)
Operation: WebFetch search + download

4️⃣ Screenshots/Official Materials (Must Cite Source)

Sources: YouTube, Bilibili, official product websites, movie posters
Applicable: Case images (product screenshots, video screenshots)
Note: Cite the source, follow fair use principles
Operation: Remind users to provide screenshots themselves, or generate AI concept images as alternatives

Image Hosting Upload Process

Core Script

Use the existing

/tools/upload_image.py

script in the project

Upload Methods

python

# Call upload script (in Bash)
python3 /Users/alchain/Documents/写作/tools/upload_image.py <image URL or local path>

# Process web images (e.g., temporary links from AI generation)
python3 /Users/alchain/Documents/写作/tools/upload_image.py "https://example.com/ai-generated.jpg"

# Process local images
python3 /Users/alchain/Documents/写作/tools/upload_image.py "/Users/alchain/Pictures/image.png"

# Script automatically returns permanent ImgBB link

Fault Tolerance Mechanism

✅ Prioritize uploading to ImgBB (permanently valid)
⚠️ Automatically use original link as fallback if upload fails
📌 See
```
/tools/README.md
```
- Image Upload Script Instructions

Markdown Insert Format

markdown

![Image Description](https://i.ibb.co/xxxxx/image.jpg)

Use permanent web links (not local paths)
Fill in meaningful image descriptions (alt text)
Keep image descriptions concise and highlight content

Image Specifications

Size Specifications

Cover image: 1200x600px (16:9)
Body image: 800-1200px wide
Character/Product: 800x800px (1:1)

File Specifications

Format: JPG (photos) / PNG (illustrations)
Size: < 500KB
Naming: lowercase, semantic, English (e.g.,
```
mrbeast.jpg
```
,
```
starry-night.jpg
```
)

Path Specifications

✅ Web link:
```
https://i.ibb.co/xxxxx/image.jpg
```
(recommended, permanently valid)
❌ Local path: No longer use local paths (will fail when copied to official account editor)

Copyright Notes

✅ Public domain works (author has been deceased for over 70 years)
✅ CC0-licensed images (Unsplash, etc.)
✅ AI-generated images (confirm tool license)
⚠️ Screenshots/official materials must cite sources

Illustration Checklist

Confirm the following before executing illustration tasks:

Article review completed, content stable
Determine number of illustrations (5-8)
Determine illustration positions (cover + core chapters)
All images obtained (AI-generated / public domain / free libraries)
All images uploaded to ImgBB
Image links are permanent web links (start with https://)
Images inserted into Markdown (using web links)
Image descriptions (alt text) filled in
All image links verified (accessible)

Execution Steps (5-Step Standard Process)

Step 1: Analyze Article, Determine Illustration Requirements

Read the full article, mark key chapters
List illustration requirement checklist (6-8 items)
Determine position and purpose of each image

Step 2: Obtain/Generate Images

Obtain images according to source priority:

Public domain works → Fetch via WebFetch
AI-generated → Call API to generate
Free image libraries → Search via WebFetch
Screenshot materials → Remind users to provide

Step 3: Upload to Image Hosting, Get Permanent Links

bash

# Call upload script for each image
python3 /Users/alchain/Documents/写作/tools/upload_image.py <image URL>

Step 4: Insert Images into Article

markdown

![Image Description](https://i.ibb.co/xxxxx/image.jpg)

Step 5: Validate Display

bash

# Check all image references
grep -n "!\[" "article-path.md"
# All image links should be web links starting with https://

Reference Resources

```
/tools/README.md
```
- Image Upload Script Instructions
```
/tools/upload_image.py
```
- Image Upload Script

/公众号写作/AI文生图API调用.md

- AI Image Generation API Instructions

/公众号写作/images/useless-content/配图Best Practice总结.md

- Illustration Best Practices Summary

Frequently Asked Questions

Q1: Will temporary links of AI-generated images expire?

A: Yes. So you must call

upload_image.py

to upload to ImgBB and get permanent links.

Q2: What if image hosting upload fails?

A: The script has a fault tolerance mechanism and will automatically fallback to the original URL. But it's recommended to check ImgBB API configuration.

Q3: Is it mandatory to add illustrations to every article?

A: Recommended, especially for long articles (over 3000 words). Short articles (under 1000 words) can only have a cover image.

Q4: Can I use local image paths?

A: Not recommended. Local paths will fail when copied to official account editors, so web links must be used.

Technical Dependencies

Python Script:
```
/tools/upload_image.py
```
(existing)
API Configuration: ImgBB API key (configured in
```
~/.zshrc
```
)
AI Generation API: Volcano Engine doubao-seedream (optional)
Tool: WebFetch (obtain public domain images)

Success Cases

《Why the Best Content is Useless》: 6 illustrations (2 public domain + 4 AI-generated)
《DeepSeek-OCR In-depth Evaluation》: 5 illustrations, all uploaded to ImgBB, no issues when copied to official account

Last Updated: 2025-11-07 Applicable Project: Official Account Writing Maintainer: Huasheng

Produced by Uncle Hua | AI Native Coder · Independent Developer Official Account "Uncle Hua" | 300k+ Followers | AI Tools & Efficiency Improvement Masterpieces: Kitten Fill Light (Top 1 in AppStore Paid List) · Mastering DeepSeek in One Book

huashu-image-upload

NPX Install

Tags

SKILL.md Content (Chinese)