wechat-article-writer

WeChat Article Writer

⚠️ Important Configuration Notes

By default, create using the AI tool's built-in capabilities, no API Key configuration required!

This skill applies to all AI tool platforms that support skills, such as Claude Code, Cursor, OpenClaw, OpenCode, Antigravity, etc. By default, it uses the AI tool's built-in capabilities for content creation, and users can use it without configuring any API Key. Only when the user explicitly needs to use an external API (such as a specific image generation service) is it necessary to configure the corresponding API Key.

Priority:

Prioritize using the AI tool's built-in capabilities to complete content creation
Use external APIs only for specific needs (such as high-quality image generation)
Simplify user operations, start creating with zero configuration

Supported platforms:

Claude Code
Cursor
OpenClaw
OpenCode
Antigravity
Other AI tools that support skills

Overview

Automated WeChat Official Account article creation skill that generates high-quality articles with AI-powered content creation and infographic generation. The skill uses a multi-agent collaboration system with specialized agents for titles, structure, and content, plus a three-layer review process to ensure professional-quality articles suitable for public account publishing.

Key Features:

Multi-Agent System: Specialized agents for titles (100+ techniques), structure design, and content writing
Three-Layer Review: Theme consistency, design & language, AI removal & colloquial optimization
Multi-Version Output: 4 variants (full/condensed × markdown/plain text)

See AGENTS.md for detailed agent specifications and workflow.

When to Use

Suitable scenarios:

Creating WeChat Official Account articles from scratch
Writing technical tutorials, industry analysis, or knowledge sharing articles
Generating articles with infographics and visual content
Producing SEO-optimized articles with structured formatting

Not suitable for:

Short social media posts (use xhs-generator instead)
Academic papers requiring strict citations
News reporting requiring real-time verification
Extremely specialized domain knowledge requiring expert review

Usage

Direct invocation in AI tool:

/wechat-article-writer "AI工具推荐:提升10倍效率的5个神器"

With custom word count:

/wechat-article-writer "AI工具推荐:提升10倍效率的5个神器" --word-count 3000

Disable web search:

/wechat-article-writer "AI工具推荐:提升10倍效率的5个神器" --no-search

The AI tool will automatically:

Load preferences from EXTEND.md (if configured)
Analyze the topic and present a plan for confirmation
Search the web for latest information (if supported and enabled)
Generate 3 engaging titles using Title Specialist Agent (100+ techniques)
Design article structure using Structure Specialist Agent
Write article content using Content Specialist Agent
Three-layer Review:
- Review 1: Theme consistency check
- Review 2: Design & language check
- Review 3: AI removal & colloquial optimization
Generate 4 article variants (full/condensed × markdown/plain text)
Generate 2 PNG infographic images (auto-generated using infographic-generator skill)
Save all outputs to the appropriate directory structure
Provide a summary with next steps

Result: A complete, publish-ready article package with text + images!

Customization via EXTEND.md:

Users can create skills/wechat-article-writer/EXTEND.md to customize:

Default writing style (knowledge, emotional, tutorial, review)
Voice (professional, casual, friendly)
Target audience
Infographic style preferences
Article length and structure preferences

Workflow

This skill is executed by AI tools (Claude Code, Cursor, OpenClaw, etc.) using their built-in capabilities.

Multi-Agent System: This skill uses a multi-agent collaboration system for article generation. See AGENTS.md for detailed agent specifications.

When user invokes /wechat-article-writer, the AI tool should:

Phase 1: Setup & Analysis

Step 0: Load Preferences - Read skills/wechat-article-writer/EXTEND.md if exists, apply default preferences
Step 1: Content Analysis - Analyze topic, determine article type, target audience, and key points
Step 1.5: Web Research (Optional) - If AI tool supports web search, search for latest information on the topic
Step 2: Smart Confirm - Present analysis results to user for confirmation before generation

Phase 2: Multi-Agent Article Generation

Step 3: Generate Titles - Use Title Specialist Agent to generate 3 engaging titles with 100+ techniques
Step 4: Design Structure - Use Structure Specialist Agent to design article framework and outline
Step 5: Generate Content - Use Content Specialist Agent to write article based on structure and titles
Step 6: Review 1 - Theme Consistency - Check if content aligns with central theme
Step 7: Review 2 - Design & Language - Check for typos, grammar, and design issues
Step 8: Review 3 - AI Removal & Colloquial Optimization - Remove AI traces and make content natural

⚠️ Important: Sub-agent invocation implementation

This system uses the Agent tool to invoke specialized sub-agents, ensuring true professional division of labor and quality improvement.

Sub-agent configuration file locations:

Title expert: skills/wechat-article-writer/agents/title-specialist.md
Structure expert: skills/wechat-article-writer/agents/structure-specialist.md
Content expert: skills/wechat-article-writer/agents/content-specialist.md
Review expert: skills/wechat-article-writer/agents/review-specialist.md

Invocation principles:

Each sub-agent has an independent role definition and professional expertise
Input complete context, without relying on conversation history
Output structured results, facilitating subsequent processing
Have a fallback strategy when failure occurs

Phase 3: Multi-Version Generation

Step 9: Generate 4 Article Versions - Generate multiple versions for different use cases:
- Full Markdown version (5000 words)
- Condensed Markdown version (1000 words)
- Full Plain Text version (WeChat compatible)
- Condensed Plain Text version (WeChat compatible, 1000 words)
Step 10: Generate Infographic Descriptions - Create detailed descriptions for 2 infographics
Step 11: Generate PNG Images - Use infographic-generator skill to generate actual PNG images

Phase 4: Output & Summary

Step 12: Save Outputs - Save all generated content to wechat-articles/{topic-slug}/ directory
Step 13: Output Summary - Present final results with file locations and next steps

Detailed Execution Guide

For AI tools executing this skill:

Step 0: Load Preferences

Read skills/wechat-article-writer/EXTEND.md if it exists. Apply these default preferences if not configured:

---
default_style: knowledge
default_voice: professional
target_audience: "大众读者"
infographic_style: notion
word_count_limit: 5000
enable_web_search: true
need_title_variants: 3
need_summary: true
---

Step 1: Content Analysis

Analyze the user's topic and determine:

Article Type: knowledge | emotional | tutorial | review
Target Audience: Who will read this article?
Content Framework: Choose appropriate structure:
- Problem-Solution-Example (for tutorials)
- What-Why-How (for knowledge articles)
- Story-Insight-Action (for emotional articles)
- Overview-Analysis-Conclusion (for reviews)
Key Points: 3-5 main points to cover

Step 1.5: Web Research (Optional)

Intelligent web research with priority-based search selection:

Execute web search to gather latest information using the best available method:

Web Search Priority (automatically select the best available method):

Priority 1: Exa AI MCP (mandatory priority - best quality)
- Check Exa AI MCP server configuration: claude mcp list | grep exa
- If available → mandatory use mcp__exa__web_search_exa tool
- Advantages:
  - 🎯 High-precision AI-driven search engine
  - 🚀 Real-time information retrieval, highest quality
  - 📊 Clear structured results
  - 💡 Powerful semantic understanding capability
- Implementation:await mcp__exa__web_search_exa({ query: searchQuery, numResults: 8 })
- ⚠️ Important rule: Even if other search tools are available, as long as Exa AI is detected, it must be used first
Priority 2: Claude Code WebSearch Tool
- Check whether the WebSearch tool is available in the environment
- If availableandExa AI is unavailable → use the built-in WebSearch tool
- Implementation:await WebSearch({ query: searchQuery })
- Note:Only when Exa AI is unavailableuse this option
Priority 3: Cursor/OpenCode/OpenClaw Built-in Capabilities
- These tools integrate web search functionality
- Use their native search capabilities
- Use when none of the above tools are available
Priority 4: Graceful Fallback
- If no web search capability is detected → use the AI knowledge base
- No errors, seamless experience
Execute search (if capability detected AND enable_web_search is true):

When to search:
- ✅ Web search capability available (from priority check)
- ✅ enable_web_search is true (default) or user hasn't disabled it
- ✅ User hasn't used --no-search flag
How to search:
- Generate 2-3 relevant search queries based on topic
- Execute searches using the highest priority available method:
  - Exa AI: mcp__exa__web_search_exa({ query: query, numResults: 8 })
  - WebSearch: WebSearch({ query: query })
- Collect latest information, data, statistics, and examples
Handle results:
- Success: Organize findings into research summary
  - Key findings and insights
  - Recent developments or trends
  - Relevant statistics or data
  - Notable examples or case studies
  - Source URLs for reference
  - Save to wechat-articles/{topic-slug}/research.md
- Failure/No capability: Skip gracefully
  - Continue to Step 2 as normal
  - Use existing knowledge base
  - No error messages to user - seamless fallback

Implementation example for Claude Code with Exa AI:

// Pseudo-code for intelligent search selection
if (enable_web_search && !no_search_flag) {
  try {
    // Priority 1: Try Exa AI MCP (best quality)
    if (hasExaAIMCP()) {
      const results = await mcp__exa__web_search_exa({
        query: searchQueries,
        numResults: 8
      });
      saveResearch(results);
    }
    // Priority 2: Fall back to WebSearch tool
    else if (typeof WebSearch !== 'undefined') {
      const results = await WebSearch({ query: searchQueries });
      saveResearch(results);
    }
    // Priority 3: Use built-in capabilities (Cursor/OpenCode)
    else if (hasBuiltInSearch()) {
      const results = await builtInSearch(searchQueries);
      saveResearch(results);
    }
    // Priority 4: Graceful fallback
    else {
      // Continue without web research
    }
  } catch (error) {
    // Search failed, continue without research
  }
}

User control:

Command line: /wechat-article-writer "topic" --no-search
Configuration: Set enable_web_search: false in EXTEND.md

Exa AI Setup (Recommended for best quality):

# Configure Exa AI MCP server
claude mcp add exa-search "https://api.exa.ai/mcp?key=YOUR_EXA_API_KEY" -t http

# Get your API key at https://exa.ai
# Free tier available with generous usage limits

Step 2: Smart Confirm

Present analysis to user:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 内容分析
  主题: {topic}
  类型: {type} | 风格: {style}
  框架: {framework}
  受众: {audience}
  字数限制: {word_count_limit}字
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 联网搜索
  状态: {已启用/已禁用/不支持}
  结果: {已获取X条最新信息/跳过}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎨 推荐方案
  风格: {style}
  信息图: {infographic_style} (2张)
  标题: {title_count}个备选
  摘要: 自动生成
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

是否继续？(Y/n)

Wait for user confirmation before proceeding.

Step 3: Generate Titles (Using Title Specialist Agent)

Invoke the title expert sub-agent to generate titles

As the main agent, you need to invoke the title expert to generate professional titles. The specific execution steps are as follows:

3.1 Prepare input parameters

Extract the following information from the previous steps:

Topic: The topic from user input
Target audience: The target audience obtained from the Step 1 analysis
Article style: From user preferences or default configuration
Word count requirement: 15-25 characters

3.2 Call the title expert

Use the Agent tool to call the title expert, following the prompt format below:

你现在是【标题专家】,专门为微信公众号文章创作高转化率的标题。

请阅读你的角色配置文件: skills/wechat-article-writer/agents/title-specialist.md

输入参数:
- 主题: {从用户输入提取的主题}
- 目标受众: {目标受众}
- 文章风格: {风格}
- 字数要求: 15-25字

请严格按照 title-specialist.md 中的规范输出,包括:
1. 生成3个标题,每个标题标注使用的技巧和理由
2. 推荐1个最佳标题并说明推荐理由

3.3 Process the output

Parse the title output:

The title expert will return output in Markdown format, including:

**标题1**: {标题内容}
- **技巧**: {技巧名称}
- **理由**: {为什么有效}

**标题2**: ...

**标题3**: ...

**推荐**: 标题{N}
**推荐理由**: {为什么推荐}

Processing steps:

Extract the content of the 3 titles
Record the technique and rationale corresponding to each title
Find the "recommendation" section and record the content of the recommended title
Verify whether the title length is 15-25 characters

Save the output:

Save the title expert's complete output to: wechat-articles/{topic-slug}/titles.md
Record the content of the recommended title for use in the next step

3.4 Quality check

Generated 3 titles
Each title is annotated with a technique and rationale
There is a clear recommended title
The title length meets the requirement (15-25 characters)

3.5 Error handling

If the title expert fails:

Use the fallback plan: generate a default title {主题} - 完整指南
Record the reason for the failure
Continue to the next step

If the output format is incomplete:

Extract the available title information
Manually select the first title as the recommendation
Mark it as "partial output"

Step 4: Design Structure (Using Structure Specialist Agent)

Call the structure expert sub-agent to design the structure

As the main agent, you need to call the structure expert to design the article structure. The specific execution steps are as follows:

4.1 Prepare input parameters

Topic: The topic from user input
Selected title: The recommended title obtained from Step 3
Target audience: The target audience obtained from the Step 1 analysis
Article style: From user preferences or default configuration
Word count requirement: Default 5000 characters or user-specified

4.2 Call the structure expert

Use the Agent tool to call the structure expert, following the prompt format below:

你现在是【结构专家】,专门为微信公众号文章设计清晰的逻辑框架和段落架构。

请阅读你的角色配置文件: skills/wechat-article-writer/agents/structure-specialist.md

输入参数:
- 主题: {主题}
- 选定标题: {从Step 3得到的推荐标题}
- 目标受众: {目标受众}
- 文章风格: {风格}
- 字数要求: {字数}字

请严格按照 structure-specialist.md 中的规范输出,包括:
1. 选择合适的文章类型并说明理由
2. 提炼中心思想(一句话概括)
3. 设计完整的文章结构大纲(开头、主体、结尾)
4. 分配各部分字数

4.3 Process the output

Parse the structure output:

The structure expert will return output in Markdown format, including:

**文章类型**: {类型名称}
**选择理由**: {为什么选择这个类型}

**中心思想**: {一句话概括}

**文章结构大纲**:

**开头部分**
- 主要内容: {...}
- 目标: {...}
- 字数: {N}字

**主体部分**
- 段落1: {...}
- 段落2: {...}
...

**结尾部分**
- 主要内容: {...}
- 字数: {N}字

Processing steps:

Extract the article type and the reason for the choice
Extract the central idea (one sentence)
Extract the complete structural outline
Verify whether the word count allocation for each part is reasonable

Save the output:

Save the structure expert's complete output to: wechat-articles/{topic-slug}/structure.md
Record the central idea for subsequent Review verification

4.4 Quality check

Selected an appropriate article type
Refined a clear central idea
Designed a complete structural outline
The word count allocation is reasonable

4.5 Error handling

If the structure expert fails:

Use the fallback plan: adopt the "general-specific-general" structure
Generate a default outline: opening (15%) + main body (70%) + ending (15%)
Record the reason for the failure

If the central idea is unclear:

Manually refine the central idea based on the topic and title
Mark it as "manually refined" model: 'sonnet' });

// Parse output const structure = parseStructureOutput(structureResult); saveToFile(wechat-articles/${topicSlug}/structure.md, structureResult);

// Extract the central theme for subsequent Review const centralTheme = structure.centralTheme;


**输出位置**: `wechat-articles/{topic-slug}/structure.md`

**质量检查:**
- [ ] 选择了合适的文章类型
- [ ] 提炼了清晰的中心思想
- [ ] 设计了完整的结构大纲
- [ ] 字数分配合理

### Step 5: Generate Content (Using Content Specialist Agent)

**调用内容专家子代理撰写内容**

作为主代理,你需要调用内容专家来撰写文章内容。以下是具体执行步骤:

#### 5.1 准备输入参数

- **主题**: 从用户输入的主题
- **选定标题**: 从Step 3得到的推荐标题
- **文章结构**: 从Step 4得到的结构大纲(完整Markdown)
- **目标受众**: 从Step 1分析得到的目标受众
- **文章风格**: 从用户偏好或默认配置

#### 5.2 调用内容专家

使用Agent工具调用内容专家,按照以下prompt格式:

You are now the [Content Specialist], specializing in writing high-quality article content based on the structure outline and title.

Please read your role configuration file: skills/wechat-article-writer/agents/content-specialist.md

Input parameters:

Topic: {Topic}
Selected title: {Recommended title obtained from Step 3}
Article structure: {Complete structure outline obtained from Step 4}
Target audience: {Target audience}
Article style: {Style}

Please output strictly according to the specifications in content-specialist.md, ensuring:

Fully follow the structure outline
The content supports the title's promise
Short paragraphs (2-4 sentences), easy to read
Supported by specific cases and data
Compliant with WeChat Official Account writing standards


#### 5.3 处理输出

**保存内容:**
- 将内容专家的完整输出保存到: `wechat-articles/{topic-slug}/content-initial.md`
- 记录内容长度和段落数

#### 5.4 质量检查

- [ ] 内容符合结构大纲
- [ ] 围绕中心思想展开
- [ ] 有具体案例和数据
- [ ] 段落简短易读(2-4句)
- [ ] 符合字数要求

#### 5.5 错误处理

**如果内容专家失败:**
- 使用降级方案: 根据结构大纲生成简化内容
- 记录失败原因
- 标注"简化版本"

**如果内容偏离结构:**
- 记录偏离部分
- 在后续Review中修正

### Step 6: Review 1 - Theme Consistency (Using Review Specialist Agent)

**调用Review专家执行中心思想一致性检查**

作为主代理,你需要调用Review专家执行第一层质量检查。以下是具体执行步骤:

#### 6.1 准备输入参数

- **中心思想**: 从Step 4结构大纲中提取的中心思想
- **文章内容**: 从Step 5生成的初始内容

#### 6.2 调用Review专家

使用Agent工具调用Review专家,按照以下prompt格式:

You are now the [Review Specialist], specializing in performing article quality checks.

Please read your role configuration file: skills/wechat-article-writer/agents/review-specialist.md

Now perform [Review 1: Central theme consistency check]

Input parameters:

Central theme: {Central theme extracted from Step 4}
Article content: {Article content generated from Step 5}

Please output according to the specifications for Review 1 in review-specialist.md:

Evaluation result (Pass/Needs revision) and confidence level (0-100)
Issue list (if there is content off-topic, mark its location)
Specific revision suggestions
Verification criteria

If revision is needed, please clearly point out the issue locations and revision direction.


#### 6.3 处理输出

**解析Review输出:**

Review专家会返回包含评估结果的输出:

```markdown
**评估结果**: {通过/需修改}
**置信度**: {0-100}

**问题列表**:
- 问题1: {描述} (位置: 第N段)
- 问题2: ...

**修改建议**: {...}

Save output:

Save the complete output of Review 1 to: wechat-articles/{topic-slug}/review-1.md

6.4 Review loop mechanism

If the evaluation result is "Needs revision":

Check retry count:
- Maintain a retry counter (initially 0)
- If retry count < 3, continue revising
- If retry count ≥ 3, mark "Partially passed", continue to Step 7

Call the Content Specialist to revise the content:

Use the Agent tool to call the Content Specialist:

你现在是【内容专家】,需要根据Review 1的反馈优化内容。

请阅读你的角色配置: skills/wechat-article-writer/agents/content-specialist.md

输入参数:
- 初始内容: {当前文章内容}
- Review 1结果: {Review 1的完整输出}

请根据Review 1的问题列表和修改建议优化内容,然后输出优化后的完整文章。

当前重试次数: {N}/3
优化策略: {根据重试次数选择: 第1次直接修改/第2次分析根源/第3次全面重写}

Update the retry counter: Retry count + 1
Re-execute Review 1: Return to Step 6.2

If the evaluation result is "Pass":

Continue to Step 7

6.5 Error handling

If the Review Specialist fails:

Use the fallback plan: mark "Not checked by Review 1"
Continue to Step 7

If Review times out (>60 seconds):

Record the timeout
Mark "Review 1 timed out"
Continue to Step 7

6.6 Quality threshold optimization (optional)

Introduce a quality threshold to avoid excessive Review:

If confidence ≥ 80 points, even "Needs revision" may be chosen to pass
Record "High-score pass" and revision suggestions
Continue to Step 7

This can reduce unnecessary retries and improve performance

Step 7: Review 2 - Design & Language (Using Review Specialist Agent)

Call the Review Specialist to perform design and language checks

As the main agent, you need to call the Review expert to perform the second-layer quality check. The specific execution steps are as follows:

7.1 Prepare input parameters

Article content: The latest current article content (may have been modified through Review 1)

7.2 Call the Review expert

Use the Agent tool to call the Review expert, following the prompt format below:

你现在是【Review专家】,专门执行文章质量检查。

请阅读你的角色配置文件: skills/wechat-article-writer/agents/review-specialist.md

现在执行【Review 2: 设计与语言检查】

输入参数:
- 文章内容: {当前文章内容}

请按照 review-specialist.md 中 Review 2 的规范输出:
1. 评估结果(通过/需修改)和置信度(0-100)
2. 问题列表(错别字、语法错误、语义不通等,标注位置)
3. 具体修改建议
4. 验证标准

7.3 Process output

Save output:

Save the complete output of Review 2 to: wechat-articles/{topic-slug}/review-2.md

7.4 Review loop mechanism

If the evaluation result is "needs modification":

Execute the same loop logic as Review 1:

Check the retry count (maximum 3 times)
Call the content expert to modify according to the Review 2 feedback
Update the retry counter
Re-execute Review 7.2

If the evaluation result is "passed":

Continue to Step 8

7.5 Error handling

If the Review expert fails:

Mark as "not checked by Review 2"
Continue to Step 8

If Review times out (>60 seconds):

Record the timeout
Mark as "Review 2 timed out"
Continue to Step 8

7.6 Quality threshold optimization (optional)

If the confidence score is ≥ 80, you may choose to pass even if it "needs modification"
Record "high-score pass" and modification suggestions
Continue to Step 8

Step 8: Review 3 - AI Removal & Colloquial Optimization (Using Review Specialist Agent)

Call the Review expert to perform de-AI-ification and colloquialization optimization

As the main agent, you need to call the Review expert to perform the third-layer quality check. The specific execution steps are as follows:

8.1 Prepare input parameters

Article content: The latest current article content (may have been modified through Review 1 and Review 2)
Target audience: The target audience obtained from the Step 1 analysis

8.2 Call the Review expert

Use the Agent tool to call the Review expert, following the prompt format below:

你现在是【Review专家】,专门执行文章质量检查。

请阅读你的角色配置文件: skills/wechat-article-writer/agents/review-specialist.md

现在执行【Review 3: 去AI化与口语化优化】

输入参数:
- 文章内容: {当前文章内容}
- 目标受众: {目标受众}

请按照 review-specialist.md 中 Review 3 的规范输出:
1. 评估结果(通过/需修改)和置信度(0-100)
2. AI痕迹列表(过度结构化、空洞表达等,标注位置)
3. 口语化建议(具体给出优化前后对比)
4. 验证标准

8.3 Process output

Save output:

Save the complete output of Review 3 to: wechat-articles/{topic-slug}/review-3.md

8.4 Review loop mechanism

If the evaluation result is "needs modification":

Execute the same loop logic as Review 1:

Check the retry count (maximum 3 times)
Call the content expert to modify according to the Review 3 feedback
Update the retry counter
Re-execute Step 8.2

If the evaluation result is "passed":

Prepare to generate the final optimized version

8.5 Generate the final optimized version

After all Reviews pass, call the content expert to generate the final version:

Use the Agent tool to call the content expert:

你现在是【内容专家】,需要根据三层Review的反馈生成最终优化版本。

请阅读你的角色配置: skills/wechat-article-writer/agents/content-specialist.md

输入参数:
- 初始内容: {当前文章内容}
- Review 1结果: {Review 1的输出}
- Review 2结果: {Review 2的输出}
- Review 3结果: {Review 3的输出}

请整合所有三层Review的修改建议,输出最终的优化文章内容。

要求:
1. 整合所有有效的修改建议
2. 确保不引入新问题
3. 保持文章完整性和连贯性

Save the final content:

Use the final optimized version as the basis for subsequent multi-version generation

8.6 Error handling

If the Review expert fails:

Mark as "not checked by Review 3"
Use the current content to continue to Step 9

If Review times out (>60 seconds):

Record the timeout
Mark as "Review 3 timed out"
Continue to Step 9

8.7 Quality threshold optimization (optional)

If the confidence score is ≥ 80, you may choose to pass even if it "needs modification"
Record "high-score pass" and modification suggestions
Continue Step 9

Review loop mechanism summary:

Each layer of Review retries at most 3 times:

1st revision: Modify directly according to the issue list
2nd revision: Analyze the root cause of the issues and make targeted modifications
3rd revision: Conduct a comprehensive review and make systematic modifications

If it still does not fully pass after 3 times, mark it as "partially passed", record the unresolved issues, and continue to the next step. This can avoid an infinite loop while ensuring quality.

Performance optimization suggestions:

Introduce a quality threshold (a score of ≥80 is sufficient to pass)
Set a timeout limit (each layer of Review takes at most 60 seconds)
Run Review 1 and Review 2 in parallel (optional)

Step 9: Generate Article Versions

The outline structure
User's voice preferences (professional/casual/friendly)
Word count limit: Stay within the specified word count limit (default 5000 words)
Research integration: If web research was conducted, incorporate relevant findings into the article
WeChat formatting best practices:
- Use emoji in section headers (📌 💡 🎯 📊 ✅)
- Keep paragraphs short (2-4 sentences)
- Use bold for emphasis
- Include practical examples

Word count management:

Monitor word count during generation
If approaching limit, prioritize essential content
Ensure conclusion section is included even if abbreviated
Note: Word count refers to Chinese characters, not English words

Using research materials (if Step 1.5 was executed):

Integrate latest data and statistics from research
Reference recent developments or trends discovered
Cite specific examples or case studies found
Ensure information is accurate and up-to-date

Save to: wechat-articles/{topic-slug}/article.md

Step 4.5: Generate Article Variants (WeChat Compatibility)

Why: WeChat Official Account articles do not support Markdown formatting. Generate multiple versions for different use cases.

Generate 3 additional versions:

1. 1000-Word Condensed Version (Markdown)

Purpose: Quick-read version for users who want the key insights without reading the full article.

Process:

Extract the most important 3-4 points from the full article
Maintain the core message and value proposition
Keep Markdown formatting for blog/platform publication
Word count: ~1000 Chinese characters (±10%)

Content guidelines:

Focus on the most impactful insights
Remove detailed examples and explanations
Keep section headers and structure
Maintain readability and flow

Save to: wechat-articles/{topic-slug}/article-1000.md

2. 1000-Word Condensed Version (Plain Text)

Purpose: Direct copy-paste to WeChat editor without formatting issues.

Process:

Use the same content as the 1000-word Markdown version
Remove all Markdown formatting:
- Remove # headers → Use plain text with line breaks
- Remove **bold** → Just plain text
- Remove *italic* → Just plain text
- Remove - list markers → Use plain text
- Remove [text](url) links → Just keep text
- Remove code blocks → Use plain text
Keep emojis in section headers (WeChat supports emojis)
Word count: ~1000 Chinese characters (±10%)

Format example:

标题：文章标题

引言段落...

📌 核心要点一
内容描述...

📌 核心要点二
内容描述...

📌 核心要点三
内容描述...

总结...

Save to: wechat-articles/{topic-slug}/article-1000-plain.txt

3. Full-Length Plain Text Version

Purpose: Complete article content without Markdown, ready for WeChat publication.

Process:

Use the full article content from Step 4
Remove all Markdown formatting:
- Remove # headers → Use plain text with line breaks
- Remove **bold** → Just plain text
- Remove *italic* → Just plain text
- Remove - list markers → Use plain text
- Remove [text](url) links → Just keep text or add as plain text reference
- Remove code blocks → Use plain text
- Remove > blockquotes → Just plain text
Keep emojis in section headers (WeChat supports emojis)
Maintain all content and examples
Word count: Same as full Markdown version

Format example:

标题：文章标题

副标题或引言...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 第一部分标题

内容段落...

💡 核心观点
详细说明...

📊 数据支持
具体数据...

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 第二部分标题

内容段落...

（以此类推）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
总结

总结内容...

Save to: wechat-articles/{topic-slug}/article-plain.txt

Quality Check:

All three versions generated
Markdown properly removed from plain text versions
Word counts match targets (1000±100 for condensed, full length for complete)
Emojis preserved in headers
Content remains coherent without Markdown formatting
Ready for direct copy-paste to WeChat editor

Step 5: Review & Refine

Critical quality control step - Review the generated article for:

Review Checklist

✅ Content Accuracy

Facts and data are correct
Code examples are valid and runnable
Technical concepts are explained accurately
No misleading or incorrect information

✅ Topic Relevance

Article stays on topic throughout
All sections directly support the main theme
No unnecessary tangents or off-topic content
Examples and cases align with the topic

✅ Structure & Flow

Logical progression from beginning to end
Clear transitions between sections
Consistent voice and tone
Balanced depth across sections

✅ Quality Standards

Clear and easy to understand
Practical and actionable
Engaging and readable
Proper formatting and emoji usage

Review Process

Self-Review: AI tool reviews its own generated content
Issue Identification: Note any problems found
Refinement: Fix identified issues
Final Check: Verify all checklist items pass

Refinement Guidelines

If issues are found:

Content errors: Correct inaccurate information
Off-topic content: Remove or redirect to the main theme
Unclear explanations: Rewrite for clarity
Missing elements: Add necessary examples or context
Poor flow: Reorganize or add transitions

Important: Do not proceed to infographic generation until the article passes all review criteria.

Save refined version to: wechat-articles/{topic-slug}/article.md (overwrite if needed)

Step 6: Generate Infographic Descriptions

Create detailed descriptions for 2 infographics that best visualize the article content.

What to describe:

Infographic 1: Core concept diagram or framework visualization
- Identify the most important concept from the article
- Design a visual representation (comparison, flow, or structure)
- Specify visual style, colors, and layout
Infographic 2: Process or method diagram
- Choose a practical process or method from the article
- Design step-by-step visualization
- Include key points and examples

Description format (save as Markdown files):

# Infographic Title

## Type
[concept-comparison | process-flow | data-visualization]

## Visual Style
- Theme: [notion | warm | minimal | professional]
- Colors: [color scheme]
- Layout: [vertical | horizontal | grid]

## Content
[Detailed description of what should be visualized]

## Text Elements
- Title: [main title]
- Headers: [section headers]
- Labels: [data labels or annotations]

## Visual Elements
- Icons needed: [list]
- Charts needed: [bar/line/pie/etc.]
- Diagram type: [flowchart/mindmap/etc.]

Save descriptions to: wechat-articles/{topic-slug}/infographic/prompts/01-*.md and 02-*.md

Step 7: Generate PNG Images

Automatically generate actual PNG images using the infographic-generator skill.

Implementation:

# For each infographic description
/infographic-generator infographic/prompts/01-*.md --output infographic/01-*.png
/infographic-generator infographic/prompts/02-*.md --output infographic/02-*.png

Process:

Check skill availability: Verify if infographic-generator skill is available
Invoke skill: Call the skill for each infographic description
Handle output: Save generated PNG images to the output directory
Fallback: If skill not available, save description files and inform user

Quality Check:

Verify PNG files are generated successfully
Check image quality and content match
If generation fails, save description for manual generation later

Output location:

wechat-articles/{topic-slug}/infographic/
├── 01-concept.png         # Generated PNG image 1
├── 02-process.png         # Generated PNG image 2
└── prompts/               # Description files (backup)
    ├── 01-concept.md
    └── 02-process.md

User Communication:

✅ If PNGs generated: "2 infographic PNG images have been generated"
⚠️ If skill unavailable: "The infographic description has been saved; you can use /infographic-generator to manually generate PNGs"

Step 8: Save Outputs

Create complete directory structure with all generated content:

wechat-articles/{topic-slug}/
├── source.md                  # User's original input
├── analysis.md                # Content analysis report
├── research.md                # Web research findings (if web search was enabled)
├── titles.md                 # 3 titles with techniques and rationales
├── structure.md              # Article structure and outline
├── content-initial.md        # Initial content before reviews
├── review-1.md              # Review 1: Theme consistency
├── review-2.md              # Review 2: Design and language
├── review-3.md              # Review 3: AI removal and colloquial
├── article-full.md          # Full article (Markdown, 5000 words)
├── article-condensed.md      # Condensed version (Markdown, 1000 words)
├── article-full-plain.txt   # Full version (Plain text, WeChat compatible)
├── article-condensed-plain.txt # Condensed version (Plain text, 1000 words)
├── infographic/               # Infographic outputs
│   ├── 01-*.png               # Generated PNG image 1
│   ├── 02-*.png               # Generated PNG image 2
│   └── prompts/               # Description files (backup)
│       ├── 01-*.md
│       └── 02-*.md
└── meta.json                  # Metadata (tags, SEO info)

Save process:

Create output directory
Save titles with techniques and rationales
Save article structure and outline
Save initial content before reviews
Save all three review results
Save 4 article variants (full/condensed × markdown/plain text)
Organize infographic assets
Generate metadata file with article stats

Step 13: Output Summary

Present comprehensive results to user:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ WeChat Article Complete!

Topic: {topic}
Style: {style}
Voice: {voice}

Output:
  📋 titles.md               (3 engaging titles)
  📋 structure.md            (Article structure)
  📄 content-initial.md      (Initial content)
  🔍 review-1.md            (Theme consistency)
  🔍 review-2.md            (Design & language)
  🔍 review-3.md            (AI removal & colloquial)
  📄 article-full.md         (Full version, Markdown, 5000 words)
  📄 article-condensed.md     (Condensed, Markdown, 1000 words)
  📄 article-full-plain.txt  (Full version, Plain text, WeChat compatible)
  📄 article-condensed-plain.txt (Condensed, Plain text, 1000 words)
  🖼️ infographic/
     ├─ 01-*.png             (PNG image 1)
     └─ 02-*.png             (PNG image 2)
  📋 meta.json               (metadata)

Files:
  ✓ {path}/titles.md
  ✓ {path}/structure.md
  ✓ {path}/content-initial.md
  ✓ {path}/review-1.md
  ✓ {path}/review-2.md
  ✓ {path}/review-3.md
  ✓ {path}/article-full.md
  ✓ {path}/article-condensed.md
  ✓ {path}/article-full-plain.txt
  ✓ {path}/article-condensed-plain.txt
  ✓ {path}/infographic/01-*.png
  ✓ {path}/infographic/02-*.png

Next Steps:
  → For WeChat: Use article-full-plain.txt or article-condensed-plain.txt
  → For Blog: Use article-full.md or article-condensed.md
  → Review all generated content
  → Preview infographic images
  → Run /baoyu-post-to-wechat to publish
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Technical Implementation Notes

This skill is designed to be executed by AI tools directly, not as standalone scripts.

AI tools read SKILL.md and execute the workflow using their built-in capabilities
No API key configuration required - AI tool's built-in capabilities are sufficient
The scripts/ directory contains optional helper scripts for advanced users only
External APIs (like Claude API) are only needed for standalone script usage

For Advanced Users: Standalone Scripts

If you want to run the skill standalone (not through an AI tool):

You'll need a Claude API key
Install Bun runtime
See scripts/README.md for detailed instructions

Most users should ignore the scripts directory and use the skill through their AI tool.

Output Structure

All outputs are saved in wechat-articles/{topic-slug}/ directory:

wechat-articles/{topic-slug}/
├── source.md                  # Original user input
├── analysis.md                # Content analysis report
├── outline.md                 # Article outline structure
├── article.md                 # Full article (Markdown, 5000 words)
├── article-1000.md            # Condensed version (Markdown, 1000 words)
├── article-1000-plain.txt     # Condensed version (Plain text, 1000 words)
├── article-plain.txt          # Full version (Plain text, no Markdown)
├── infographic/               # Generated infographics
│   ├── 01-*.png               # PNG image 1 (auto-generated)
│   ├── 02-*.png               # PNG image 2 (auto-generated)
│   └── prompts/               # Image description files (backup)
│       ├── 01-*.md            # Description for image 1
│       └── 02-*.md            # Description for image 2
└── meta.json                  # Article metadata (tags, SEO, statistics)

Key Deliverables:

✅ titles.md: 3 engaging titles with techniques and rationales
✅ structure.md: Article structure and outline
✅ content-initial.md: Initial content before reviews
✅ review-1.md: Theme consistency review results
✅ review-2.md: Design and language review results
✅ review-3.md: AI removal and colloquial optimization results
✅ article-full.md: Complete article (Markdown, 5000 words)
✅ article-condensed.md: Condensed version (Markdown, 1000 words)
✅ article-full-plain.txt: Full version for WeChat (Plain text, no Markdown)
✅ article-condensed-plain.txt: Condensed version for WeChat (Plain text, 1000 words)
✅ PNG images: 2 high-quality infographics (auto-generated)
✅ research.md: Latest information and data (if web search enabled)
✅ meta.json: SEO metadata for publishing

WeChat Publishing Guide:

For WeChat Official Account: Use article-full-plain.txt or article-condensed-plain.txt
Why: These files have no Markdown formatting, ready for direct copy-paste
Note: Emojis in headers are preserved (WeChat supports emojis)
For other platforms (blog, knowledge base): Use Markdown versions (article-full.md, article-condensed.md)
Review process: All articles go through three layers of review (theme consistency, design & language, AI removal & colloquial optimization)

Preferences Configuration

Create skills/wechat-article-writer/EXTEND.md to customize default preferences:

## Writing Preferences

### Content Style
- **Language**: Chinese (Simplified)
- **Tone**: Professional yet accessible
- **Word count limit**: 5000 (customizable, default 5000)
- **Structure**: Problem → Solution → Examples → Conclusion

### Format Preferences
- **Headings**: H1, H2, H3 hierarchy
- **Lists**: Numbered for procedures, bullet for features
- **Code blocks**: Include for technical topics
- **Tables**: For comparisons and data

### Infographic Style
- **Theme**: Clean, modern, professional
- **Color palette**: Blue/gray/green scheme
- **Elements**: Icons, charts, diagrams

Examples

Example 1: Technical Tutorial

/wechat-article-writer "Go语言微服务架构实践:从零到部署"

Output:

Topic: Microservices architecture with Go
Sections: Background, Architecture Design, Implementation, Deployment, Best Practices
Infographics: Architecture diagram, workflow chart, deployment process

Example 2: Industry Analysis

/wechat-article-writer "2024年AI发展趋势与商业应用分析"

Output:

Topic: AI industry trends and business applications
Sections: Market Overview, Key Trends, Business Cases, Future Outlook
Infographics: Market size chart, trend timeline, application matrix

Common Pitfalls

Skipping content analysis - Always analyze the topic before generation to ensure quality
Not customizing preferences - Default preferences may not match your writing style
Missing infographics - Visual content significantly increases article engagement
Poor outline structure - A good outline is essential for coherent article flow
Ignoring SEO - Include keywords and meta information for search optimization

References

WeChat Official Account Publishing Guidelines
AI Content Generation Best Practices
Infographic Design Principles
Technical Writing Standards

Future Enhancements

Multi-platform publishing support (WeChat, Zhihu, Juejin)
Automatic SEO optimization
Template library for common article types
Collaborative editing features
Performance analytics integration

About this skill

⚠️ Important Configuration Notes

Overview

When to Use

Usage

Workflow

Phase 1: Setup & Analysis

Phase 2: Multi-Agent Article Generation

Phase 3: Multi-Version Generation

Phase 4: Output & Summary

Detailed Execution Guide

Step 0: Load Preferences

Step 1: Content Analysis

Step 1.5: Web Research (Optional)

Step 2: Smart Confirm

Step 3: Generate Titles (Using Title Specialist Agent)

3.1 Prepare input parameters

3.2 Call the title expert

3.3 Process the output

3.4 Quality check

3.5 Error handling

Step 4: Design Structure (Using Structure Specialist Agent)

4.1 Prepare input parameters

4.2 Call the structure expert

4.3 Process the output

4.4 Quality check

4.5 Error handling

6.4 Review loop mechanism

6.5 Error handling

6.6 Quality threshold optimization (optional)

Step 7: Review 2 - Design & Language (Using Review Specialist Agent)

7.1 Prepare input parameters

7.2 Call the Review expert

7.3 Process output

7.4 Review loop mechanism

7.5 Error handling

7.6 Quality threshold optimization (optional)

Step 8: Review 3 - AI Removal & Colloquial Optimization (Using Review Specialist Agent)

8.1 Prepare input parameters

8.2 Call the Review expert

8.3 Process output

8.4 Review loop mechanism

8.5 Generate the final optimized version

8.6 Error handling

8.7 Quality threshold optimization (optional)

Step 9: Generate Article Versions

Step 4.5: Generate Article Variants (WeChat Compatibility)

1. 1000-Word Condensed Version (Markdown)

2. 1000-Word Condensed Version (Plain Text)

3. Full-Length Plain Text Version

Step 5: Review & Refine

Review Checklist

Review Process

Refinement Guidelines

Step 6: Generate Infographic Descriptions

Step 7: Generate PNG Images

Step 8: Save Outputs

Step 13: Output Summary

Technical Implementation Notes

For Advanced Users: Standalone Scripts

Output Structure

Preferences Configuration

Examples

Example 1: Technical Tutorial

Example 2: Industry Analysis

Common Pitfalls

References

Future Enhancements