Xiaohu Wechat Format — Documentation skill for Claude Code

xiaohu-wechat-format

A Claude Code skill for the full WeChat Official Account (公众号) publishing pipeline: **Format** → **Cover** (optional) → **Publish** — with 30 themes, a visual gallery picker, AI content enhancement, and one-click publishing to drafts.

**[中文说明](README_CN.md)**


What It Does

1. Markdown → WeChat HTML: Converts standard Markdown into inline-styled HTML that works in WeChat's editor (no tags, no classes — everything inline)
2. 30 Themes: From newspaper-style serif to neon cyberpunk, organized into 5 categories
3. Visual Gallery: Preview 20 core themes with your actual article in a browser, then pick one
4. AI Content Enhancement: Auto-detects dialogue, key quotes, and image sequences — wraps them in styled containers
5. One-Click Publish: Uploads images to WeChat CDN and pushes the article to your drafts


Quick Start

# Install
cd ~/.claude/skills/
git clone https://github.com/xiaohuailabs/xiaohu-wechat-format.git
cp xiaohu-wechat-format/config.example.json xiaohu-wechat-format/config.json
pip3 install markdown requests

# Format an article (opens gallery in browser)
python3 scripts/format.py --input article.md --gallery

# Format with a specific theme
python3 scripts/format.py --input article.md --theme newspaper

# Publish to WeChat drafts
python3 scripts/publish.py --dir /tmp/wechat-format/article-name/ --cover cover.jpg

Using with Claude Code

Just say:

排版这篇文章 /path/to/article.md

Claude will:

1. Read and analyze your article
2. Auto-enhance content (add dialogue containers, callout blocks, etc.)
3. Open the theme gallery in your browser
4. You pick a theme, tell Claude the name
5. Claude formats and optionally publishes to WeChat

Themes (30)

Standalone Styles (9)

Theme	ID	Style
Terracotta	terracotta	Warm orange, rounded headers
ByteDa