# Huashu Image Upload

> One-click generation and upload of article illustrations to an image host, with automatic Markdown link insertion. Use when the user mentions "illustrations", "article images", "upload images", or "image for the article".

- **Type:** Skill
- **Install:** `agentstack add skill-biraj2004-huashu-skills-english-huashu-image-upload-en`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Biraj2004](https://agentstack.voostack.com/s/biraj2004)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Biraj2004](https://github.com/Biraj2004)
- **Source:** https://github.com/Biraj2004/huashu-skills-english/tree/main/huashu-image-upload-en
- **Website:** https://github.com/alchaincyf/huashu-skills

## Install

```sh
agentstack add skill-biraj2004-huashu-skills-english-huashu-image-upload-en
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Image Generation & Upload

A professional capability for automatically generating illustrations for WeChat articles, uploading them to an image host, and inserting Markdown links.

## When to Use This Skill

This skill is automatically loaded when the following scenarios are detected:

- The user says "add illustrations now", "help me with illustrations", or "add images"
- After article proofreading is complete and illustrations are needed
- When the article content is complete but images are missing

## Core Features

1. **Analyse illustration requirements**: Determine 5–8 illustrations needed based on article content
2. **Source images from**:
   - Public domain works (Wikimedia Commons, Google Arts & Culture)
   - AI-generated images (Volcano Engine doubao-seedream API)
   - Free stock libraries (Unsplash, Pexels)
3. **Auto-upload to image host**: Call ImgBB to obtain permanent links
4. **Insert Markdown**: Insert image links at the appropriate positions in the article
5. **Verify display**: Ensure all image links are valid

## Illustration Quantity Guidelines

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

## Illustration Placement Strategy

**Mandatory placement**:

- ✅ Cover image (hero image): Below the title — always required
- ✅ Core sections: 1 image per key section

**Optional placement**:

- Theory support (e.g., referencing a classic work)
- Data visualisation (comparison charts, graphs)
- Case supplements (product screenshots, examples)

## Image Source Priority

### 1️⃣ Public Domain Works (Highest Priority)

- **Sources**: Wikimedia Commons, Google Arts & Culture
- **Suitable for**: Classic artwork, historical portraits, ancient book covers
- **Advantages**: Free, no copyright issues, high quality
- **Examples**: Van Gogh's Starry Night, Kant portrait
- **Method**: Use WebFetch to obtain Wikimedia Commons image links

### 2️⃣ AI-Generated (Recommended)

- **Source**: Volcano Engine doubao-seedream-4-0-250828
- **Suitable for**: Cover images, concept art, abstract themes
- **Advantages**: Original, customisable, fast
- **Method**: Call API to generate image, returns a temporary URL

### 3️⃣ Free Stock Libraries

- **Sources**: Unsplash, Pexels, Pixabay
- **Suitable for**: Cover images, concept art, background images
- **Advantages**: Free, high quality, commercially usable (CC0)
- **Method**: WebFetch search + download

### 4️⃣ Screenshots / Official Assets (Citation required)

- **Sources**: YouTube, Bilibili, product websites, film posters
- **Suitable for**: Case images (product screenshots, video stills)
- **Note**: Cite the source; use under fair use principles
- **Method**: Remind user to take their own screenshot, or generate an AI concept image as a substitute

## Image Host Upload Workflow

### Core Script

Use the project's existing `/tools/upload_image.py` script

### Upload Method

```python
# Call upload script (via Bash)
python3 /Users/alchain/Documents/writing/tools/upload_image.py 

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

# Handle local images
python3 /Users/alchain/Documents/writing/tools/upload_image.py "/Users/alchain/Pictures/image.png"

# Script automatically returns ImgBB permanent link
```

### Fallback Mechanism

- ✅ Prefer uploading to ImgBB image host (permanent links)
- ⚠️ If upload fails, automatically use the original URL as a fallback
- 📌 See `/tools/README.md` for image upload script documentation

## Markdown Insert Format

```markdown

```

- Use permanent network links (not local paths)
- Write a meaningful image description (alt text)
- Keep descriptions concise and focused on the image content

## Image Specifications

### Size Specifications

- Cover image: 1200 x 600px (16:9)
- Body images: 800–1200px wide
- Person/product: 800 x 800px (1:1)

### File Specifications

- Format: JPG (photos) / PNG (illustrations)
- Size: 
```

### Step 4: Insert images into article

```markdown

```

### Step 5: Verify display

```bash
# Check all image references
grep -n "!\[" "article-path.md"
# All image links should start with https://
```

## Reference Resources

- `/tools/README.md` — Image upload script documentation
- `/tools/upload_image.py` — Image upload script
- `/writing/AI-image-generation-API.md` — AI image generation API documentation
- `/writing/images/illustration-best-practices.md` — Illustration best practices

## Frequently Asked Questions

### Q1: Will AI-generated image temporary links expire?

**A**: Yes. That's why you must call `upload_image.py` to upload to ImgBB and get a permanent link.

### Q2: What if the image host upload fails?

**A**: The script has a fallback mechanism and will automatically use the original URL. However, it's recommended to check your ImgBB API configuration.

### Q3: Does every article need illustrations?

**A**: Illustrations are strongly recommended, especially for long articles (3,000+ words). Short articles (under 1,000 words) may only need a cover image.

### Q4: Can local image paths be used?

**A**: Not recommended. Local paths break when pasted into the WeChat editor — always use network links.

## Technical Dependencies

- **Python script**: `/tools/upload_image.py` (already in place)
- **API configuration**: ImgBB API key (configured in `~/.zshrc`)
- **AI generation API**: Volcano Engine doubao-seedream (optional)
- **Tools**: WebFetch (for retrieving public domain images)

## Success Examples

- **"Why the Best Content Is Useless"**: 6 illustrations (2 public domain + 4 AI-generated)
- **"DeepSeek-OCR In-Depth Review"**: 5 illustrations, all uploaded to ImgBB, copy-pasted to WeChat without issue

---

**Last Updated**: 2025-11-07
**Applicable Projects**: WeChat article writing
**Maintained by**: Huashu

---

> **By Huashu** | AI Native Coder · Independent Developer
> WeChat Official Account "Huashu" | 300k+ followers | AI Tools & Productivity
> Flagship products: Kitty Catchlight (AppStore Paid Rankings Top 1) · *Play DeepSeek with One Book*

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Biraj2004](https://github.com/Biraj2004)
- **Source:** [Biraj2004/huashu-skills-english](https://github.com/Biraj2004/huashu-skills-english)
- **License:** MIT
- **Homepage:** https://github.com/alchaincyf/huashu-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-biraj2004-huashu-skills-english-huashu-image-upload-en
- Seller: https://agentstack.voostack.com/s/biraj2004
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.