X Long-Form Post Writer skill

Write long-form X (Twitter) posts and threads in a founder/CEO voice.

by ericosiu·MIT license·★ 3,615 Stars on the repo·GitHub ↗

Use now

Files of X Long-Form Post Writer

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 

Discussion

Alternatives

STEP 0: STALE-CLONE SELF-CHECK — RUN BEFORE READING BELOWResearch 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.Marketing · MITApifyScrapes 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).Marketing · MITTwitter/X SkillSearch 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.Marketing · Apache-2.0🎬 YouTube Script: Writing retention-optimized video script...Use 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.Business & ops · MIT