Content Writer Skill
Installation
npx clawhub@latest install content-writer-mcbai
Generate professional social media posts from research articles. Supports LinkedIn, Facebook, Twitter/X, TikTok caption, Threads — taking source material and producing polished, platform-optimized posts.
When to Use
- User has articles/data and wants to create social media posts
- User wants to write a post in a specific format
- User needs content for any platform: LinkedIn, Facebook, Twitter/X, TikTok, Threads
- User asks to "write a post", "viết bài", "tạo content" from any source material
- Works best after using the
content-research skill to gather sources
Core Workflow
Step 1: Gather Inputs
Collect from the user (ask if not provided):
- Source material (required) — article, URL, summary, or raw data
- Platform (default: LinkedIn) — LinkedIn / Facebook / Twitter/X / TikTok / Threads
- Content format (default: toplist) — see 6 formats below
- Tone (default: default) — see Tone Presets
- Length (default: medium) — short/medium/long
- Language (default: Vietnamese) — English or Vietnamese
- Number of posts (default: 1)
Step 2: Select Format
Read the appropriate format reference file:
| Format |
File |
Best For |
| 📋 Toplist |
references/format-toplist.md |
Numbered lists with data |
| 💡 POV |
references/format-pov.md |
Bold opinions backed by data |
| 🏢 Case Study |
references/format-case-study.md |
Deep-dive one story |
| 🛠️ How-to |
references/format-how-to.md |
Step-by-step guides |
| 📖 Story |
references/format-story.md |
Narrative, emotional journey |
| 🎯 Hook-List-CTA |
references/format-hook-list-cta.md |
Facebook viral format |
Step 3: Apply Platform Rules
Read references/platform-rules.md for platform-specific constraints. Quick reference:
| Platform |
Max length |
Style |
Hashtag |
| LinkedIn |
3,000 chars |
Professional, data-driven |
3-5 tags |
| Facebook |
63,206 chars |
Conversational, emotional, story |
0-3 tags |
| Twitter/X |
280 chars |
Punchy, hook-heavy |
1-2 tags |
| TikTok |
2,200 chars (caption) |
Casual, trendy, FOMO |
5-10 tags |
| Threads |
500 chars |
Conversational, casual |
0-2 tags |
Step 4: Build the Prompt
Combine:
- Brand context — read
references/brand-context.md
- Format instructions — from selected format file
- Platform rules — from
references/platform-rules.md
- Source material — articles/data provided
- Tone + Language + Length instructions
Step 5: Generate Content
Output rules (non-negotiable):
- Plain text only — no markdown rendering on social platforms
- ZERO asterisks — no
*, no **
- No em dashes (—) — use
- or comma
- No source URLs in post body
- No markdown (
#, [], ())
- Short paragraphs — 1-2 sentences max
- Data-driven — every claim backed by numbers
- For emphasis: use CAPS on 1-2 key words
- Lists: use numbers (
1. 2. 3.) or arrows (→)
- Emoji: use naturally per platform style (Facebook/TikTok: more; LinkedIn: 2-3 max)
Step 6: Present and Refine
Offer after generating:
- Regenerate with different format/tone/length/platform
- Create variants for A/B testing
- Generate versions for multiple platforms simultaneously
Format Structures
Toplist
HOOK: Bold claim + specific number
CONTEXT: Why this matters now
LIST: Numbered items with data points
TAKEAWAY: Pattern that emerges
CTA: Engagement question
POV
HOOK: Contrarian bold opening
DATA: Evidence with numbers
ANALYSIS: What this means
PREDICTION: Clear position
CTA: Provocative question
Case Study
HOOK: Most impressive metric
CONTEXT: Problem that existed
WHAT THEY DID: Strategy + numbers
RESULTS: Concrete outcomes
LESSON: Non-obvious takeaway
CTA: Engagement or MCB AI mention
How-to
HOOK: Promise clear outcome
WHY: What people get wrong
STEPS: 3-7 numbered, action verbs
PRO TIP: Non-obvious shortcut
RESULT: What they'll achieve
CTA: "Try step 1 today"
Story (Facebook-optimized)
OPENING SCENE: Specific moment, pulls reader in
TENSION: Problem/conflict builds
TURNING POINT: Insight or decision
RESOLUTION: Outcome + lesson
CTA: Relatable question or tag prompt
Hook-List-CTA (Facebook viral)
HOOK (1 line): Stop-the-scroll — question, shock, or bold claim
BLANK LINE
LIST: 5-10 short punchy items (emoji optional)
BLANK LINE
CTA: "Tag ai cũng cần biết điều này" hoặc câu hỏi
Tone Presets
Read references/tone-presets.md for full details:
| Tone |
Style |
| Default |
Data-driven, confident, accessible |
| Bold |
Provocative, contrarian, strong positions |
| Educational |
Teacher mode, analogies, "here's why" |
| Storytelling |
Narrative arc, scenes, emotional |
| Analytical |
Research analyst, patterns, comparisons |
| Viral |
FOMO-driven, emotional trigger, share-bait |
| Empathetic |
Warm, understanding, community-focused |
| Custom |
User provides own tone description |
Length Guidelines
| Length |
Words |
Chars |
Best for |
| Short |
50-100 |
~300-600 |
Twitter/X, Threads, TikTok caption |
| Medium |
150-300 |
~800-1800 |
LinkedIn, Facebook standard |
| Long |
400-700 |
~2500-4500 |
LinkedIn deep dive, Facebook story |
Reference Files
references/brand-context.md — MCB AI brand identity + writing rules
references/format-toplist.md — Toplist format instructions
references/format-pov.md — POV format instructions
references/format-case-study.md — Case Study instructions
references/format-how-to.md — How-to format instructions
references/format-story.md — Story format instructions (Facebook-optimized)
references/format-hook-list-cta.md — Hook-List-CTA viral format
references/tone-presets.md — All tone details + Viral + Empathetic presets
references/platform-rules.md — Platform-specific constraints
references/formatting-rules.md — Critical formatting rules (MUST read)
Critical Rules (Non-Negotiable)
- ABSOLUTELY NO asterisks (*) anywhere
- ABSOLUTELY NO markdown formatting
- ABSOLUTELY NO em dashes (—)
- ABSOLUTELY NO source URLs in post
- Output MUST be plain text only
- Emphasis = CAPS on 1-2 words max
- Lists = numbers or → arrows only
- Emoji = natural, platform-appropriate (not excessive on LinkedIn)
1---2name: content-writer-33description: Generate high-quality social media posts from research articles and source data. Supports multiple platforms (LinkedIn, Facebook, Twitter/X, TikTok caption, Threads), 6 content formats (Toplist, POV, Case Study, How-to, Story, Hook-List-CTA), multiple tones (default, bold, educational, storytelling, analytical, viral, empathetic, custom), 3 lengths (short/medium/long), and 2 languages (English/Vietnamese). Use this skill whenever the user wants to write a post, create social media content, draft content from research data, generate content in any format, or asks to "write a post", "viết bài", "tạo nội dung", "draft a post", "generate a post from this article", or any content writing from source material.4---5
6# Content Writer Skill
7
8## Installation
9
10```bash
11npx clawhub@latest install content-writer-mcbai
12```
13
14Generate professional social media posts from research articles. Supports LinkedIn, Facebook, Twitter/X, TikTok caption, Threads — taking source material and producing polished, platform-optimized posts.
15
16## When to Use
17
18- User has articles/data and wants to create social media posts
19- User wants to write a post in a specific format
20- User needs content for any platform: LinkedIn, Facebook, Twitter/X, TikTok, Threads
21- User asks to "write a post", "viết bài", "tạo content" from any source material
22- Works best after using the `content-research` skill to gather sources
23
24## Core Workflow
25
26### Step 1: Gather Inputs
27
28Collect from the user (ask if not provided):
29
301. **Source material** (required) — article, URL, summary, or raw data
312. **Platform** (default: LinkedIn) — LinkedIn / Facebook / Twitter/X / TikTok / Threads
323. **Content format** (default: toplist) — see 6 formats below
334. **Tone** (default: default) — see Tone Presets
345. **Length** (default: medium) — short/medium/long
356. **Language** (default: Vietnamese) — English or Vietnamese
367. **Number of posts** (default: 1)
37
38### Step 2: Select Format
39
40Read the appropriate format reference file:
41
42| Format | File | Best For |
43|--------|------|----------|
44| 📋 Toplist | `references/format-toplist.md` | Numbered lists with data |
45| 💡 POV | `references/format-pov.md` | Bold opinions backed by data |
46| 🏢 Case Study | `references/format-case-study.md` | Deep-dive one story |
47| 🛠️ How-to | `references/format-how-to.md` | Step-by-step guides |
48| 📖 Story | `references/format-story.md` | Narrative, emotional journey |
49| 🎯 Hook-List-CTA | `references/format-hook-list-cta.md` | Facebook viral format |
50
51### Step 3: Apply Platform Rules
52
53Read `references/platform-rules.md` for platform-specific constraints. Quick reference:
54
55| Platform | Max length | Style | Hashtag |
56|----------|-----------|-------|---------|
57| LinkedIn | 3,000 chars | Professional, data-driven | 3-5 tags |
58| Facebook | 63,206 chars | Conversational, emotional, story | 0-3 tags |
59| Twitter/X | 280 chars | Punchy, hook-heavy | 1-2 tags |
60| TikTok | 2,200 chars (caption) | Casual, trendy, FOMO | 5-10 tags |
61| Threads | 500 chars | Conversational, casual | 0-2 tags |
62
63### Step 4: Build the Prompt
64
65Combine:
661. **Brand context** — read `references/brand-context.md`
672. **Format instructions** — from selected format file
683. **Platform rules** — from `references/platform-rules.md`
694. **Source material** — articles/data provided
705. **Tone + Language + Length** instructions
71
72### Step 5: Generate Content
73
74Output rules (non-negotiable):
75- **Plain text only** — no markdown rendering on social platforms
76- **ZERO asterisks** — no `*`, no `**`
77- **No em dashes** (—) — use `-` or comma
78- **No source URLs** in post body
79- **No markdown** (`#`, `[]`, `()`)
80- **Short paragraphs** — 1-2 sentences max
81- **Data-driven** — every claim backed by numbers
82- For emphasis: use CAPS on 1-2 key words
83- Lists: use numbers (`1. 2. 3.`) or arrows (`→`)
84- Emoji: use naturally per platform style (Facebook/TikTok: more; LinkedIn: 2-3 max)
85
86### Step 6: Present and Refine
87
88Offer after generating:
89- Regenerate with different format/tone/length/platform
90- Create variants for A/B testing
91- Generate versions for multiple platforms simultaneously
92
93## Format Structures
94
95### Toplist
96```
97HOOK: Bold claim + specific number
98CONTEXT: Why this matters now
99LIST: Numbered items with data points
100TAKEAWAY: Pattern that emerges
101CTA: Engagement question
102```
103
104### POV
105```
106HOOK: Contrarian bold opening
107DATA: Evidence with numbers
108ANALYSIS: What this means
109PREDICTION: Clear position
110CTA: Provocative question
111```
112
113### Case Study
114```
115HOOK: Most impressive metric
116CONTEXT: Problem that existed
117WHAT THEY DID: Strategy + numbers
118RESULTS: Concrete outcomes
119LESSON: Non-obvious takeaway
120CTA: Engagement or MCB AI mention
121```
122
123### How-to
124```
125HOOK: Promise clear outcome
126WHY: What people get wrong
127STEPS: 3-7 numbered, action verbs
128PRO TIP: Non-obvious shortcut
129RESULT: What they'll achieve
130CTA: "Try step 1 today"
131```
132
133### Story (Facebook-optimized)
134```
135OPENING SCENE: Specific moment, pulls reader in
136TENSION: Problem/conflict builds
137TURNING POINT: Insight or decision
138RESOLUTION: Outcome + lesson
139CTA: Relatable question or tag prompt
140```
141
142### Hook-List-CTA (Facebook viral)
143```
144HOOK (1 line): Stop-the-scroll — question, shock, or bold claim
145BLANK LINE
146LIST: 5-10 short punchy items (emoji optional)
147BLANK LINE
148CTA: "Tag ai cũng cần biết điều này" hoặc câu hỏi
149```
150
151## Tone Presets
152
153Read `references/tone-presets.md` for full details:
154
155| Tone | Style |
156|------|-------|
157| Default | Data-driven, confident, accessible |
158| Bold | Provocative, contrarian, strong positions |
159| Educational | Teacher mode, analogies, "here's why" |
160| Storytelling | Narrative arc, scenes, emotional |
161| Analytical | Research analyst, patterns, comparisons |
162| Viral | FOMO-driven, emotional trigger, share-bait |
163| Empathetic | Warm, understanding, community-focused |
164| Custom | User provides own tone description |
165
166## Length Guidelines
167
168| Length | Words | Chars | Best for |
169|--------|-------|-------|---------|
170| Short | 50-100 | ~300-600 | Twitter/X, Threads, TikTok caption |
171| Medium | 150-300 | ~800-1800 | LinkedIn, Facebook standard |
172| Long | 400-700 | ~2500-4500 | LinkedIn deep dive, Facebook story |
173
174## Reference Files
175
176- `references/brand-context.md` — MCB AI brand identity + writing rules
177- `references/format-toplist.md` — Toplist format instructions
178- `references/format-pov.md` — POV format instructions
179- `references/format-case-study.md` — Case Study instructions
180- `references/format-how-to.md` — How-to format instructions
181- `references/format-story.md` — Story format instructions (Facebook-optimized)
182- `references/format-hook-list-cta.md` — Hook-List-CTA viral format
183- `references/tone-presets.md` — All tone details + Viral + Empathetic presets
184- `references/platform-rules.md` — Platform-specific constraints
185- `references/formatting-rules.md` — Critical formatting rules (MUST read)
186
187## Critical Rules (Non-Negotiable)
188
1891. ABSOLUTELY NO asterisks (*) anywhere
1902. ABSOLUTELY NO markdown formatting
1913. ABSOLUTELY NO em dashes (—)
1924. ABSOLUTELY NO source URLs in post
1935. Output MUST be plain text only
1946. Emphasis = CAPS on 1-2 words max
1957. Lists = numbers or → arrows only
1968. Emoji = natural, platform-appropriate (not excessive on LinkedIn)
197
198