X Long-Form Post Writer

Write long-form X posts and threads in a founder/CEO voice

by ericosiu · MIT license · ★ 3,615 on GitHub

X Long-Form Post Writer cover

Write long-form X (Twitter) posts and threads in a founder/CEO voice. Use when drafting X articles, long tweets, thought leadership threads, or viral content.

---
name: x-longform-post
description: Write long-form X (Twitter) posts and threads in a founder/CEO voice. Use when drafting X articles, long tweets, thought leadership threads, or viral content. Produces contrarian, data-backed posts with ASCII diagrams and code block visuals. Includes mandatory AI humanizer pass (24-pattern detector) before finalizing.
---

# X Long-Form Post Writer

Write posts for X in your founder/CEO's authentic voice. Every post should feel like a real person wrote it — not a content team, not a bot.

See `references/founder-voice.md` for the founder voice template. Customize it with your founder's real patterns.

---

## Voice Rules

- Simple declarative sentences. Short paragraphs.
- Contrarian angles backed by specific numbers and real examples.
- No corporate speak. No "I'm excited to share." No emoji in body text.

Overview

Write posts for X in your founder/CEO's authentic voice. Every post should feel like a real person wrote it — not a content team, not a bot.

Manual install (npx, ZIP)
Claude Codenpx skills add ericosiu/ai-marketing-skills --skill x-longform-post -g -a claude-code
Claude Code (degit)npx degit ericosiu/ai-marketing-skills/x-longform-post#main ~/.claude/skills/x-longform-post
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md8.0 KB
Read SKILL.md here
ericosiu/main1 file shown
SKILL.md
Show the full text203 lines

X Long-Form Post Writer

Write posts for X in your founder/CEO's authentic voice. Every post should feel like a real person wrote it — not a content team, not a bot.

See references/founder-voice.md for the founder voice template. Customize it with your founder's real patterns.


Voice Rules

  • Simple declarative sentences. Short paragraphs.
  • Contrarian angles backed by specific numbers and real examples.
  • No corporate speak. No "I'm excited to share." No emoji in body text.
  • Open with a hook that stops the scroll — contrarian claim, surprising number, or uncomfortable truth.
  • End with a payoff: uncomfortable truth → "worth it" resolution.

Structure

  1. Hook (1-2 lines) — Contrarian claim or surprising stat
  2. Setup (2-3 lines) — Establish credibility/context fast
  3. Sections — Each follows: problem → what actually happened → fix/lesson
  4. ASCII diagram — At least one per post (see below)
  5. Uncomfortable truth — The insight most people avoid
  6. Payoff — Was it worth it? Yes, and here's why.

ASCII Diagrams (MANDATORY)

Every post MUST include at least one ASCII diagram in a code block. These break up walls of text and make complex systems visual.

Use box-drawing characters:

┌─────────┐    ┌─────────┐    ┌─────────┐
│  Input  │───►│ Process │───►│ Output  │
└─────────┘    └─────────┘    └─────────┘

Diagram types to use:

  • System architecture — boxes connected by arrows showing how components relate
  • Before/after — side-by-side comparison of old vs new state
  • Flow diagrams — decision trees, pipelines, sequences
  • Hierarchy — org charts, priority stacks, dependency trees
  • Metrics — simple bar charts using block characters (█ ▓ ░)

Keep diagrams:

  • Under 40 chars wide (mobile rendering)
  • Simple enough to parse in 3 seconds
  • Labeled clearly — no ambiguous boxes

Example — system flow:

Input (60s)
    │
    ▼
┌──────────┐
│ Process  │ step 1
└────┬─────┘
     ▼
┌──────────┐
│ Dispatch │ step 2
└────┬─────┘
     ▼
  Output

Example — metrics visualization:

Performance by Category:
Category A   ████████████ 100%
Category B   ████████░░░░  67%
Category C   ░░░░░░░░░░░░   0%

Formatting for X

  • X articles support markdown-like formatting in long posts
  • Use code blocks (```) for ASCII art — they render in monospace on X
  • Bold with asterisks where supported
  • Keep paragraphs to 1-3 sentences max
  • Line breaks between every thought

Content Sources

Pull from real data whenever possible:

  • Real metrics from your business
  • Specific incidents and debugging stories
  • Actual decisions made and why

Never fabricate metrics. Use real numbers or don't use numbers.


Analytics Feedback Loop

If X/Twitter analytics are available, use them before drafting and after publishing.

Before drafting:

  • Pull recent post performance for similar topics and formats.
  • Compare impressions, engagement rate, replies, reposts, bookmarks, profile clicks, follower delta, post length, hook style, proof number, CTA type, and topic bucket.
  • Prefer hooks and structures that have actually worked. Do not worship cleverness. Cleverness without distribution is theater with better fonts.

After publishing:

  1. Log post URL/id, publish time, hook, title, proof number, structure, CTA, and topic bucket.
  2. Pull analytics after the readback window.
  3. Compare against a baseline cohort of similar posts.
  4. Patch the title formulas, hook patterns, CTA rules, or section structure only if the candidate beats baseline or produces a clearly better audience signal.

Judgment metrics:

  • impressions
  • engagement rate
  • replies
  • reposts
  • bookmarks
  • profile clicks
  • follower delta
  • quality of replies

Every promoted format change should include a baseline window, candidate window, metric winner, caveats, and rollback rule.


Input Format

User provides:

  • Topic: What the post is about
  • Angle: The contrarian or unique framing
  • Source material: Real examples, data, incidents (optional)

Output

Deliver the complete post ready to paste into X. No preamble, no "here's your post" — just the post itself.

If the post would work better as a thread (>1500 chars), split into numbered tweets with each one standalone valuable.


Reference

See references/founder-voice.md for extended voice examples and patterns. Customize with your founder's real voice.


Humanizer Checklist (MANDATORY — Run Before Finalizing)

Before returning any X article draft, check against ALL 24 humanizer patterns. If any pattern is detected, rewrite that section.

For the full humanizer expert scoring rubric, see: ../content-ops/experts/humanizer.md

CRITICAL: No "Not X, It's Y" Constructions

Never write "This is not X. This is Y." or "That is not X, that is Y." or any variant. These are the #1 AI slop tell. Say what something IS directly. Don't define by negation.

Banned Vocabulary (never use these)

delve, tapestry, landscape (abstract), leverage, multifaceted, nuanced, pivotal, realm, robust, seamless, testament, transformative, underscore (verb), utilize, whilst, keen, embark, comprehensive, intricate, commendable, meticulous, paramount, groundbreaking, innovative, cutting-edge, synergy, holistic, paradigm, ecosystem, Additionally, crucial, enduring, enhance, fostering, garner, highlight (verb), interplay, intricacies, showcase, vibrant, valuable, profound, renowned, breathtaking, nestled, stunning

Pattern Checklist
  1. ☐ No significance inflation ("pivotal moment", "stands as", "is a testament")
  2. ☐ No undue notability claims (listing media mentions without context)
  3. ☐ No superficial -ing phrases ("highlighting", "showcasing", "underscoring")
  4. ☐ No promotional language ("boasts", "vibrant", "profound", "commitment to")
  5. ☐ No vague attributions ("Experts believe", "Industry reports suggest")
  6. ☐ No formulaic "despite challenges... continues to" structures
  7. ☐ No AI vocabulary clustering (multiple banned words in one paragraph)
  8. ☐ No copula avoidance ("serves as", "stands as" — just use "is")
  9. ☐ No negative parallelisms ("It's not just X, it's Y")
  10. ☐ No rule-of-three forcing (triple adjectives, triple parallel clauses)
  11. ☐ No synonym cycling (varying terms for the same thing unnecessarily)
  12. ☐ No false ranges ("from X to Y" on no meaningful scale)
  13. ☐ No em dash overuse (max 1 per 200 words)
  14. ☐ No mechanical boldface emphasis
  15. ☐ No inline-header vertical lists (bolded label + colon pattern)
  16. ☐ No Title Case In Every Heading
  17. ☐ No emoji decoration on headings/bullets
  18. ☐ No curly quotation marks
  19. ☐ No collaborative artifacts ("I hope this helps", "Let me know")
  20. ☐ No knowledge-cutoff disclaimers
  21. ☐ No sycophantic tone ("Great question!")
  22. ☐ No filler phrases ("In order to", "It is important to note")
  23. ☐ No excessive hedging ("could potentially", "might have some effect")
  24. ☐ No generic positive conclusions ("The future looks bright", "Exciting times ahead")
Humanizer Scoring

Start at 100. Deduct points per the rubric in ../content-ops/experts/humanizer.md.

  • 90-100: Human-sounding. Clean. Ship it.
  • 70-89: Minor AI tells. Quick fixes needed.
  • 50-69: Obvious AI patterns. Significant rewrite needed.
  • 0-49: Full rewrite.
1---
2name: x-longform-post
3description: Write long-form X (Twitter) posts and threads in a founder/CEO voice. Use when drafting X articles, long tweets, thought leadership threads, or viral content. Produces contrarian, data-backed posts with ASCII diagrams and code block visuals. Includes mandatory AI humanizer pass (24-pattern detector) before finalizing.
4---
5 
6# X Long-Form Post Writer
7 
8Write posts for X in your founder/CEO's authentic voice. Every post should feel like a real person wrote it — not a content team, not a bot.
9 
10See `references/founder-voice.md` for the founder voice template. Customize it with your founder's real patterns.
11 
12---
13 
14## Voice Rules
15 
16- Simple declarative sentences. Short paragraphs.
17- Contrarian angles backed by specific numbers and real examples.
18- No corporate speak. No "I'm excited to share." No emoji in body text.
19- Open with a hook that stops the scroll — contrarian claim, surprising number, or uncomfortable truth.
20- End with a payoff: uncomfortable truth → "worth it" resolution.
21 
22---
23 
24## Structure
25 
261. **Hook** (1-2 lines) — Contrarian claim or surprising stat
272. **Setup** (2-3 lines) — Establish credibility/context fast
283. **Sections** — Each follows: problem → what actually happened → fix/lesson
294. **ASCII diagram** — At least one per post (see below)
305. **Uncomfortable truth** — The insight most people avoid
316. **Payoff** — Was it worth it? Yes, and here's why.
32 
33---
34 
35## ASCII Diagrams (MANDATORY)
36 
37Every post MUST include at least one ASCII diagram in a code block. These break up walls of text and make complex systems visual.
38 
39Use box-drawing characters:
40```
41┌─────────┐ ┌─────────┐ ┌─────────┐
42│ Input │───►│ Process │───►│ Output │
43└─────────┘ └─────────┘ └─────────┘
44```
45 
46Diagram types to use:
47- **System architecture** — boxes connected by arrows showing how components relate
48- **Before/after** — side-by-side comparison of old vs new state
49- **Flow diagrams** — decision trees, pipelines, sequences
50- **Hierarchy** — org charts, priority stacks, dependency trees
51- **Metrics** — simple bar charts using block characters (█ ▓ ░)
52 
53Keep diagrams:
54- Under 40 chars wide (mobile rendering)
55- Simple enough to parse in 3 seconds
56- Labeled clearly — no ambiguous boxes
57 
58Example — system flow:
59```
60Input (60s)
61 │
62 ▼
63┌──────────┐
64│ Process │ step 1
65└────┬─────┘
66 ▼
67┌──────────┐
68│ Dispatch │ step 2
69└────┬─────┘
70 ▼
71 Output
72```
73 
74Example — metrics visualization:
75```
76Performance by Category:
77Category A ████████████ 100%
78Category B ████████░░░░ 67%
79Category C ░░░░░░░░░░░░ 0%
80```
81 
82---
83 
84## Formatting for X
85 
86- X articles support markdown-like formatting in long posts
87- Use code blocks (```) for ASCII art — they render in monospace on X
88- Bold with asterisks where supported
89- Keep paragraphs to 1-3 sentences max
90- Line breaks between every thought
91 
92---
93 
94## Content Sources
95 
96Pull from real data whenever possible:
97- Real metrics from your business
98- Specific incidents and debugging stories
99- Actual decisions made and why
100 
101Never fabricate metrics. Use real numbers or don't use numbers.
102 
103---
104 
105## Analytics Feedback Loop
106 
107If X/Twitter analytics are available, use them before drafting and after publishing.
108 
109Before drafting:
110- Pull recent post performance for similar topics and formats.
111- Compare impressions, engagement rate, replies, reposts, bookmarks, profile clicks, follower delta, post length, hook style, proof number, CTA type, and topic bucket.
112- Prefer hooks and structures that have actually worked. Do not worship cleverness. Cleverness without distribution is theater with better fonts.
113 
114After publishing:
1151. Log post URL/id, publish time, hook, title, proof number, structure, CTA, and topic bucket.
1162. Pull analytics after the readback window.
1173. Compare against a baseline cohort of similar posts.
1184. Patch the title formulas, hook patterns, CTA rules, or section structure only if the candidate beats baseline or produces a clearly better audience signal.
119 
120Judgment metrics:
121- impressions
122- engagement rate
123- replies
124- reposts
125- bookmarks
126- profile clicks
127- follower delta
128- quality of replies
129 
130Every promoted format change should include a baseline window, candidate window, metric winner, caveats, and rollback rule.
131 
132---
133 
134## Input Format
135 
136User provides:
137- **Topic**: What the post is about
138- **Angle**: The contrarian or unique framing
139- **Source material**: Real examples, data, incidents (optional)
140 
141---
142 
143## Output
144 
145Deliver the complete post ready to paste into X. No preamble, no "here's your post" — just the post itself.
146 
147If the post would work better as a thread (>1500 chars), split into numbered tweets with each one standalone valuable.
148 
149---
150 
151## Reference
152 
153See `references/founder-voice.md` for extended voice examples and patterns. Customize with your founder's real voice.
154 
155---
156 
157## Humanizer Checklist (MANDATORY — Run Before Finalizing)
158 
159Before returning any X article draft, check against ALL 24 humanizer patterns. If any pattern is detected, rewrite that section.
160 
161For the full humanizer expert scoring rubric, see: `../content-ops/experts/humanizer.md`
162 
163### CRITICAL: No "Not X, It's Y" Constructions
164Never write "This is not X. This is Y." or "That is not X, that is Y." or any variant. These are the #1 AI slop tell. Say what something IS directly. Don't define by negation.
165 
166### Banned Vocabulary (never use these)
167delve, tapestry, landscape (abstract), leverage, multifaceted, nuanced, pivotal, realm, robust, seamless, testament, transformative, underscore (verb), utilize, whilst, keen, embark, comprehensive, intricate, commendable, meticulous, paramount, groundbreaking, innovative, cutting-edge, synergy, holistic, paradigm, ecosystem, Additionally, crucial, enduring, enhance, fostering, garner, highlight (verb), interplay, intricacies, showcase, vibrant, valuable, profound, renowned, breathtaking, nestled, stunning
168 
169### Pattern Checklist
1701. ☐ No significance inflation ("pivotal moment", "stands as", "is a testament")
1712. ☐ No undue notability claims (listing media mentions without context)
1723. ☐ No superficial -ing phrases ("highlighting", "showcasing", "underscoring")
1734. ☐ No promotional language ("boasts", "vibrant", "profound", "commitment to")
1745. ☐ No vague attributions ("Experts believe", "Industry reports suggest")
1756. ☐ No formulaic "despite challenges... continues to" structures
1767. ☐ No AI vocabulary clustering (multiple banned words in one paragraph)
1778. ☐ No copula avoidance ("serves as", "stands as" — just use "is")
1789. ☐ No negative parallelisms ("It's not just X, it's Y")
17910. ☐ No rule-of-three forcing (triple adjectives, triple parallel clauses)
18011. ☐ No synonym cycling (varying terms for the same thing unnecessarily)
18112. ☐ No false ranges ("from X to Y" on no meaningful scale)
18213. ☐ No em dash overuse (max 1 per 200 words)
18314. ☐ No mechanical boldface emphasis
18415. ☐ No inline-header vertical lists (bolded label + colon pattern)
18516. ☐ No Title Case In Every Heading
18617. ☐ No emoji decoration on headings/bullets
18718. ☐ No curly quotation marks
18819. ☐ No collaborative artifacts ("I hope this helps", "Let me know")
18920. ☐ No knowledge-cutoff disclaimers
19021. ☐ No sycophantic tone ("Great question!")
19122. ☐ No filler phrases ("In order to", "It is important to note")
19223. ☐ No excessive hedging ("could potentially", "might have some effect")
19324. ☐ No generic positive conclusions ("The future looks bright", "Exciting times ahead")
194 
195### Humanizer Scoring
196 
197Start at 100. Deduct points per the rubric in `../content-ops/experts/humanizer.md`.
198 
199- **90-100**: Human-sounding. Clean. Ship it.
200- **70-89**: Minor AI tells. Quick fixes needed.
201- **50-69**: Obvious AI patterns. Significant rewrite needed.
202- **0-49**: Full rewrite.
203 
View all files on GitHub →

Details

License
MIT
Stars on the repo
★ 3,615
Checked
Source
ericosiu/ai-marketing-skills ↗
Creator
ericosiu · 34 listings
View creator

Similar skills

See all →
SkillLast 30 Days Researchmvanhorn/last30days-skill · by mvanhornResearch what people actually say about any topic in the last 30 days. Pulls posts and engagement from Reddit, X, YouTube, TikTok, Hacker News, Polymarket, GitHub, and the web. Includes a doctor health check to diagnose broken or missing sources.★ 63.5k GitHub starsSkillSocial Platform Scraperdanielmiessler/LifeOS · by danielmiesslerScrapes social platforms, business data, and e-commerce via Apify actors — Instagram, LinkedIn, TikTok, YouTube, Facebook, Google Maps, Amazon, and web crawls — filtering in code. USE WHEN scrape Instagram, scrape LinkedIn, scrape TikTok, scrape YouTube, scrape Facebook, Google Maps leads, Amazon reviews, business intelligence, multi-platform social listening, competitive analysis, lead generation, social monitoring, Apify actors, web crawl, extract contacts. NOT FOR X/Twitter account operations like posting, threads, or bookmarks (those need a dedicated X API client), 4-tier progressive scraping with proxy escalation (use BrightData), or real-Chrome bot bypass and computer use (use Interceptor).★ 19.3k GitHub starsSkillWeChat Article Publishertsingyuai/growth-lab · by tsingyuai微信公众号长文增长闭环 —— 从读者问题与复刻锚选题、写出可验证的公众号长文、预览与合规检查、同步微信草稿、三重确认下受控发布,到回收阅读与转化数据并复盘。用户要求写公众号、把内容改成公众号、同步或发布微信草稿、查看公众号数据或复盘时使用。★ 2k GitHub starsSkillTwitter Content SearchReScienceLab/opc-skills · by ReScienceLabSearch and retrieve content from Twitter/X. Get user info, tweets, replies, followers, communities, spaces, and trends via twitterapi.io. Use when user mentions Twitter, X, or tweets.★ 1.8k GitHub starsSkillYouTube Script Writercwinvestments/memstack · by cwinvestmentsUse this skill when the user says 'YouTube script', 'video script', 'write script for YouTube', 'YouTube video outline', or is creating scripted content for a YouTube video with hooks, chapters, and CTAs. Do NOT use for TikTok/Reels short-form scripts or webinar presentations.★ 423 GitHub starsSkillInternet Research RouterOotto-AI/claude-content-skills · by Ootto-AIMUST USE when user wants to 调研/research/搜索/search/查/找/look up anything on the internet — e.g. 全网调研 X / 帮我调研一下 X / 查一下 X / 搜搜 X / 看看大家怎么评价 X / X 上有什么讨论 / research this topic。 Also MUST USE when user mentions any platform or shares any URL/链接: 小红书/xiaohongshu/xhs, Twitter/推特/X, B站/bilibili, Reddit, V2EX, LinkedIn/领英/招聘/求职/jobs, YouTube, GitHub code search, 小宇宙播客, 雪球/股票行情, RSS feeds, or any web URL. 13 platforms, multi-backend routing (OpenCLI / per-platform CLIs / APIs). Zero config for 6 channels. Run `agent-reach doctor --json` to see which backend serves each platform right now. NOT for: 写报告/数据分析/翻译等内容加工(本 skill 只负责从互联网获取内容); 发帖/评论/点赞等写操作;已有专门 skill 的平台(先用专门 skill)。 【路由方式】SKILL.md 包含路由表和常用命令,复杂场景需按需阅读对应分类的 references/*.md。 分类:search / social (小红书/推特/B站/V2EX/Reddit) / career(LinkedIn) / dev(github) / web(网页/文章/RSS) / video(YouTube/B站/播客)。★ 139 GitHub stars

More from ericosiu

SkillVideo Moment Extraction Agentericosiu/ai-marketing-skills · by ericosiuUse when an agent must extract moments, quotes, objections, hooks, or evidence from long video or audio cheaper than full-frame ingest — sales calls, podcasts, YouTube episodes, Loom trials, discovery recordings. Goal-directed watch via Gemini agentic video understanding (frames, audio, or transcript). Not for cutting, overlays, rendering, scheduling, or publishing.★ 3.6k GitHub starsSkillConversion Operationsericosiu/ai-marketing-skills · by ericosiupython3 telemetry/versioncheck.py 2>/dev/null || true★ 3.6k GitHub starsSkillFinance Operationsericosiu/ai-marketing-skills · by ericosiuAI-powered financial analysis suite. Generates executive CFO briefings from QuickBooks exports (P&L, Balance Sheet, General Ledger, Cash Flow, etc.) with anomaly detection, burn rate, runway analysis, and scenario modeling. Also estimates codebase development costs with organizational overhead and AI ROI analysis. Triggers on: 'CFO briefing', 'financial analysis', 'cost briefing', 'expense review', 'runway analysis', 'burn rate', 'cost estimate', 'how much would this cost to build', 'development cost', 'Claude ROI'.★ 3.6k GitHub starsSkillRevenue Intelligence Dashboardericosiu/ai-marketing-skills · by ericosiupython3 telemetry/versioncheck.py 2>/dev/null || true★ 3.6k GitHub starsSkillSales Pipeline Managerericosiu/ai-marketing-skills · by ericosiupython3 telemetry/versioncheck.py 2>/dev/null || true★ 3.6k GitHub starsSkillValue-Based Sales Playbookericosiu/ai-marketing-skills · by ericosiupython3 telemetry/versioncheck.py 2>/dev/null || true★ 3.6k GitHub stars