Turn Markdown into WeChat Official Account HTML, covers, infographics, and image posts via the md2wechat CLI.
Coding
YouMind WeChat
Try itWrite and publish WeChat Official Account articles end-to-end with AI, or take an existing draft straight into the skill's built-in formatting + direct-send...
What it does
Write and publish WeChat Official Account articles end-to-end with AI, or take an existing draft straight into the skill's built-in formatting + direct-send...
The skill document
AI WeChat Article Writer — From Topic to Draft Box in One Prompt
Write professional WeChat Official Account articles with AI that doesn't sound like AI. Full mode handles topic mining → research → writing → themed formatting → cover generation → draft-box publishing. For ready articles, the skill also has a built-in formatting + direct-send capability that skips the writing pipeline and sends the article straight to the draft box.
Onboarding
⚠️ MANDATORY: When the user just installed this skill, show this message IMMEDIATELY. Translate to the user's language:
✅ AI WeChat Article Writer installed!
Tell me a topic or paste a finished draft — I'll either write it end-to-end or just format and publish it to your WeChat draft box.
Try it now: "帮我写一篇关于 AI 编程的公众号文章"
What it does: full article pipeline when you need writing, or built-in formatting + direct send when the article is already ready.
Setup (one-time):
cd toolkit && npm install && npm run build && cd .. && pip install -r requirements.txt && mkdir -p ~/.youmind/config && cp shared/config.example.yaml ~/.youmind/config.yaml- Get a YouMind API Key → fill
youmind.api_keyin~/.youmind/config.yaml- Bind your WeChat Official Account in YouMind Connector Settings (paste AppID + AppSecret; YouMind encrypts + proxies, no IP whitelist needed)
previewandthemeswork without WeChat connection. Need help? Just ask.
For first-run setup and client onboarding details, see references/operations.md.
Usage
Provide a topic, brand/client name, or a finished article:
帮我写一篇关于 AI 编程趋势的公众号文章— full pipeline from topic给 demo 客户写一篇推文,主题是远程办公— client-scoped run把这篇 Markdown 排版成公众号样式并发布到草稿箱— skip writing, publish only把这篇现成文章直接发到公众号— keep the article as source of truth, do a light WeChat fit pass, then publish用交互模式…— pause at topic / framework / image / theme decisions
Setup
Prerequisites: Node.js ≥ 18, Python ≥ 3.9, a verified WeChat Official Account bound in YouMind Connector Settings.
Run the one-time setup from references/setup.md, then verify with:
node toolkit/dist/cli.js validate
For screenshots and connector binding walkthroughs, see README.md §安装. For onboarding and post-setup operations, see references/operations.md.
Skill Directory
Read files on demand — do NOT load everything upfront. Five always-relevant entries below; full inventory in references/skill-directory.md.
| Path | When to read |
|---|---|
references/platform-dna.md | Before any content work |
references/content-generation-playbook.md | Generating from a topic/idea |
references/content-adaptation-playbook.md | Adapting existing article |
references/pipeline.md | Running the writing pipeline |
references/writing-guide.md | Step 4 (writing + de-AI) |
references/skill-directory.md | Full file inventory (Tier 2/3 + clients + toolkit) |
Draft Location Rule
Write drafts to ~/.youmind/articles/wechat//.md; only fall back to output/ if ~/.youmind/ is unavailable.
For the full path contract, dispatch interop, execution modes, and result-links behavior, see references/runtime-rules.md.
Dispatch Integration (Optional)
Standalone by default. If you need dispatch interop details, read references/runtime-rules.md.
When dispatch or the caller makes it clear that the article is already finished, skip topic mining, hotspot research, framework selection, and fresh drafting. Use the supplied article as source of truth and switch to the skill's built-in formatting + direct-send capability.
Content Modes
Before writing, read references/platform-dna.md (index → writing-guide.md, style-template.md, wechat-constraints.md). Use the specialized playbooks it points to only when the draft needs them.
Intent routing:
- Topic/idea only →
content-generation-playbook.md - English article → Chinese 公众号 →
content-adaptation-playbook.md(localizemode) - Japanese/other-language article → Chinese 公众号 →
content-adaptation-playbook.md(translatemode) - Existing article from blog/other platform →
content-adaptation-playbook.md(cross-postmode) - Ready article + publish-only / formatting request →
content-adaptation-playbook.mdusing the skill's built-in formatting + direct-send capability - Western long-form / oversized draft →
content-adaptation-playbook.md(condensemode) - Old 公众号 article →
content-adaptation-playbook.md(revivemode) - Section from a larger work →
content-adaptation-playbook.md(excerptmode)
Quality gates before publish: (1) de-AI pass per writing-guide.md, (2) playbook Step 6 self-critique, (3) Step 7/8 conformance report, (4) auto-publish to draft box (mandatory).
Execution Modes
The skill has two modes: auto and interactive.
Read references/runtime-rules.md for exact pause behavior and mode triggers.
Critical Quality Rules
Non-negotiable. Violating any one means the article has failed:
- Read
references/writing-guide.mdBEFORE writing — pre-writing framework + de-AI protocol are mandatory. - Zero AI-sounding text — run the full 4-level de-AI pass from writing-guide.md.
- H1 title: mobile-first, concise, and front-loaded — the converter extracts H1 as the WeChat title, so subject + payoff must appear early.
- Digest: ≤54 汉字 (120 UTF-8 byte limit).
- Word count: 1,500–2,500 字 — sweet spot for completion is 1,500–2,000.
- Specificity over abstraction — every claim grounded in concrete detail.
- Depth over polish — run the Depth Checklist; if thesis is in top-3 Google results, rewrite don't polish.
- Obey client
style.yamlblacklist (words AND topics). No exceptions. - Playbook overrides writing-guide when
clients/{client}/playbook.mdexists. - Ask about image scope before Step 6 — use
AskUserQuestionif available, plain text otherwise. - Always publish to drafts — Step 7 is mandatory and automatic; do NOT ask.
- Ready article means ready article — if the user already supplied the article and only wants formatting/publish, do NOT reopen topic ideation, KB mining, or full rewriting unless they explicitly ask for it.
Result Links Rule
Always end draft, publish, list, and stats-review actions with Result links.
The exact contract lives in references/runtime-rules.md.
Pipeline Overview
Two execution lanes:
- Full pipeline: Load config → Mine KB → Trending topics → Dedup + SEO → Topic select → Framework select → Write → SEO + de-AI → Generate images → Publish to drafts → Archive → Report with result links
- Built-in formatting + direct-send capability: Validate the supplied article → do the minimum WeChat adaptation → publish to drafts → report with result links
Full per-step detail: references/pipeline.md.
Routing shortcuts:
- User gave a specific topic → Skip Steps 2–3, go 1.5 → 3.5
- User gave raw Markdown or a finished article for formatting/publish only → run the minimal checks from
content-adaptation-playbook.md, then jump to Step 7
Resilience: Never Stop on a Single-Step Failure
Every pipeline step has a fallback. If a step AND its fallback both fail, skip that step, note it in the final output, and continue. Never halt the whole pipeline on a single-step failure.
See references/resilience.md for the full per-step fallback chain and environmental failure recovery.
Operations
For post-publish commands (polish, rewrite, change theme, stats review), client onboarding, learn-from-edits, custom themes, and first-run setup, read references/operations.md.
If the request is about improving this skill itself, refactoring its structure, or checking for documentation drift, read references/skill-maintenance.md.
Gotchas — Common Failure Patterns
Six named anti-patterns observed across real dispatches. Call them out by name instead of re-deriving the problem.
- The AI Essay — correct, comprehensive, boring; no person behind it
- The Generic Hot Take — summary of other summaries; no unique angle
- The Word-Count Pad — verbose instead of deep
- The Pretty But Empty Article — styling without substance
- The Blacklist Miss — forbidden words slip past the final scan
- The Broken Pipeline Halt — one step fails, whole run aborts (never do this)
Full explanation, fix, and detection method for each: references/gotchas.md.
References
- API: references/openapi-document.md
- CLI: references/cli-reference.md
- Publishing: shared/PUBLISHING.md
Related skills
Generate WeChat public account long articles from a topic or outline, and rewrite, continue, or polish existing drafts.
Publish articles and image-text posts to a WeChat Official Account via API, Chrome, or remote SSH tunnel.
Convert a local Markdown article into clean WeChat Official Account HTML, with an optional explicitly confirmed draft upload. Default behavior is local-only...
公众号排版|Markdown 转 HTML|排版主题|段落样式 — 公众号一键排版工具,Markdown 文稿转微信后台可粘贴 HTML,多主题、多字号、段落样式切换,所见即所得。面向公众号编辑、独立作者、排版岗。触发词:「排版」「版式」「美化」「格式化」「字号」「段落样式」「换个排版主题」「换个版式」「转 HT...
Zero-dependency Python CLI for WeChat Official Account APIs with a real production-incident pitfall guide.