SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsarticle-writer

article-writer

Writing & research

View repository

Updated 10-16 06:50

About this skill

Multi-Style Article Creation

Use Cases

  • User says "Write an article about XX"
  • User says "Help me write a WeChat official account article"
  • User selects a topic from the content calendar to start writing
  • User specifies a writing style (e.g., "in-depth analysis style", "write a tutorial")

5 Writing Styles

Style ID Name Characteristics Word Count Use Cases
deep-analysis In-depth analysis Rigorous structure, data-backed 2000-4000 words Trend analysis, in-depth reporting
practical-guide Practical guide Clear steps, highly actionable 1500-3000 words Tool tutorials, how-to guides
story-driven Story-driven Conversational, emotional resonance 1500-2500 words Personal stories, case reviews
opinion Opinion commentary Sharp opening, pros/cons argumentation 1000-2000 words Hot takes, controversial topics
news-brief News brief Inverted pyramid, fact-focused 500-1000 words Breaking news, information roundups

Workflow

Step 1: Read the Brief

Obtain topic information from:

  1. Entries with status planned in content_calendar.json
  2. Topic description directly provided by the user

Extract key information:

  • Topic direction / title
  • Target audience
  • Writing style (if not specified, recommend based on topic content)
  • Reference material URLs

Step 2: Determine Writing Style

If user hasn't specified, recommend based on topic:

Topic Characteristics Recommended Style
Involves data, trends, underlying causes deep-analysis
"How to", "tutorial", "steps" practical-guide
Involves people, experiences, insights story-driven
Involves controversy, hot topic commentary opinion
Breaking events, quick information news-brief

Confirm the style choice with the user.

Step 3: Material Collection

Use content-planner's search script to collect reference materials:

node "$SKILLS_ROOT/content-planner/scripts/wechat_search.js" "topic keywords" -n 10

Also use web-search skill for additional materials.

Organize material list:

  • Citable data/statistics
  • Reference cases/stories
  • Facts that need verification

Step 4: Generate Outline

Generate an outline based on the selected style using the corresponding structure template.

deep-analysis Template

## 引入 (200-300字) — 反直觉数据/现象开头
## 背景 (300-500字) — 事件/现象的来龙去脉
## 分析维度1 (400-600字) — 核心论点 + 数据支撑
## 分析维度2 (400-600字) — 对比/反面论证
## 分析维度3 (400-600字) — 深层原因 + 影响预测
## 总结与展望 (200-300字) — 核心观点 + CTA

practical-guide Template

## 开头 (100-200字) — 痛点共鸣 + 承诺
## 前置准备 (200-300字)
## 步骤1 (300-500字) — 具体操作 + 常见坑
## 步骤2 (300-500字) — 具体操作 + 关键参数
## 步骤3 (300-500字) — 具体操作 + 验证方法
## 进阶技巧 (200-300字)
## 总结 (100-200字) — FAQ + CTA

story-driven Template

## 开头 (150-200字) — 场景切入 + 悬念
## 背景铺垫 (200-300字) — 人物/背景/冲突
## 转折1 (300-400字) — 关键事件 + 感受
## 转折2 (300-400字) — 新尝试 + 结果
## 高潮 (200-300字) — 核心洞察
## 结尾 (150-200字) — 启发 + CTA

opinion Template

## 锐利开头 (100-150字) — 直接亮观点
## 现象描述 (200-300字) — 主流观点
## 正面论证 (300-400字) — 我的论点 + 数据
## 反面回应 (200-300字) — 预设反驳 + 反驳
## 深度思考 (200-300字) — 本质 + 影响
## 总结 (100-150字) — 重申观点 + CTA

news-brief Template

## 核心信息 (100-200字) — What/When/Where/Who
## 事件详情 (200-300字)
## 背景 (100-200字)
## 反应 (100-200字)
## 编者按 (50-100字)

Step 5: User Approval of Outline

This is a mandatory approval gate and cannot be skipped.

Present the outline to the user and ask for confirmation or modification requests.

Step 6: Write the Content

After approval, write content paragraph by paragraph following the outline.

Universal Writing Rules:

  1. Use stories instead of preaching

    • ❌ "Risk management is very important; you should have an emergency plan"
    • ✅ "Last year, my startup team almost collapsed because a core employee left, because we had no backup plan at all."

  2. Use analogies and metaphors

    • ❌ "Distributed systems are very complex"
    • ✅ "A distributed system is like a chain restaurant—each branch needs to collaborate while also operating independently."

  3. Support with data but don't pile it on

    • ❌ "According to an IDC report, the global AI market grew 45% in 2023 and is expected to reach $100 billion by 2025..."
    • ✅ "The AI market is growing like crazy—doubling every year. But behind the growth, fewer than 5 companies are truly making money."

  4. State opinions directly, avoid ambiguity

    • ❌ "Some people think... others think... each has a point"
    • ✅ "To be honest, I think XX's approach is wrong, because..."

  5. Use short sentences and line breaks

Data integrity rules:

  • If specific data is needed but uncertain, mark [数据待确认] and confirm with user
  • Use search tools to verify key facts
  • Can tell fictional stories using "I've seen..." or "A friend...", but don't fabricate data

Step 7: Formatting Optimization

WeChat Formatting Hard Rules:

  1. Paragraphs no more than 4 lines (mobile screen visible range)
  2. Insert a subheading or bold sentence every 3-4 paragraphs
  3. Must have a hook within the first 3 lines (question, data, story, counter-intuitive viewpoint)
  4. Must have a clear CTA at the end (follow/share/comment prompt)

Markdown Formatting Standards:

  • No first-line indentation, use blank lines to separate paragraphs
  • Maximum 2 heading levels (##), no deep nesting
  • Bold only the 1-2 most important words per paragraph
  • Use quotes for data, golden sentences, or important viewpoints
  • Lists maximum 5 items

Step 8: Output Draft

Save the article as Markdown:

Filename format: drafts/YYYYMMDD_[topic-slug].md

---
title: Article Title
date: YYYY-MM-DD
style: deep-analysis
summary: Article summary (within 100 words)
---

## Opening

Content...

Step 9: Quality Checklist

✅ Title — Sparks curiosity or resonance
✅ Opening — First 100 words are engaging
✅ Body — Has 2-3 clear viewpoints
✅ Cases — Uses stories not preaching
✅ Formatting — Easy to read (short paragraphs, bold, subheadings)
✅ Word Count — Within style-specified range
✅ CTA — Ending has action prompt

Title Optimization Process

Step 1: Generate 10 Candidate Titles

Use these psychological strategies:

Strategy Description Example
Suspense Spark curiosity "Why I gave up a job with an annual salary of 500,000"
Benefit Clarify reader gains "Master these 3 techniques and increase efficiency by 200%"
Pain Point Hit reader anxiety "Don't let this habit ruin your career"
Numbers Specific and tangible "50% of people misunderstand this truth"
Rhetorical Stimulate thinking "Do you really understand AI?"
Contrast Create contrast "BAT vs startups: What's the difference"

Step 2: Score and Filter

Score on 3 dimensions (Attractiveness 40%, Shareability 30%, SEO 30%) and present top 3 to user.

Integration with Other Skills

  • Upstream: content-planner's content_calendar.json provides topic input
  • Downstream: Markdown files in drafts/ can be further processed