X Articles

X Articles — Viral Long-Form for Twitter

Beat the algorithm. Create and publish X (Twitter) Articles with proven viral patterns.

AI-powered formatting, hook patterns, and browser automation. Handles Draft.js quirks, embed limitations, and image uploads.

Quick Reference

Content Formatting Rules (CRITICAL)

X Articles uses Draft.js editor with specific quirks:

1. Line breaks = paragraph breaks - Each newline creates a new paragraph block with spacing 2. Join sentences on ONE LINE - All sentences in the same paragraph must be on a single line 3. Use plain text, not markdown - X Articles uses rich text, not markdown 4. No em dashes (—) - Replace with colons or rewrite sentences

Wrong:

Sentence one.
Sentence two.
Sentence three.

Right:

Sentence one. Sentence two. Sentence three.

Embed Limitation (IMPORTANT)

Embedded posts ALWAYS render at the END of the content block, not inline.

Workarounds:

• Structure article to reference "see posts below"
• Accept visual flow: text → text → embeds at bottom
• Use Insert > Posts menu (don't paste URLs)

Image Specs

Viral Article Structure

The Template

HOOK (hit insecurity or opportunity)

WHAT IT IS (1-2 paragraphs with social proof)

WHY MOST PEOPLE WON'T DO IT (address objections)

THE [X]-MINUTE GUIDE
- Step 1 (time estimate)
- Step 2 (time estimate)
- ...

YOUR FIRST [N] WINS (immediate value)
- Win 1: copy-paste example
- Win 2: copy-paste example

THE COST (value comparison)

WHAT TO DO AFTER (next steps)

THE WINDOW (urgency)

CTA (soft or hard)

Hook Patterns That Work

Insecurity/FOMO:

everyone's talking about X... and you're sitting there wondering if you missed the window

Big Opportunity:

this is the biggest opportunity of our lifetime

News Hook:

X just open sourced the algo. Here's what it means for you:

RIP Pattern:

RIP [profession]. This AI tool will [action] in seconds.

WTF Pattern:

WTF!! This AI Agent [does amazing thing]. Here's how:

Personal Story:

When I was young, I was always drawn to people who...

CTA Patterns

Hard CTA (engagement bait):

RT + follow + reply 'KEYWORD' and I'll send the cheat sheet

Soft CTA:

If you take this advice and build something, let me know!

Simple:

Feel free to leave a like and RT if this helped.

Style Guide

Damian Player Style (Tactical)

• All lowercase (deliberate)
• Urgent, tactical tone
• 1500+ words
• Heavy step-by-step detail
• Hard CTA with lead magnet

Alex Finn Style (Motivational)

• Normal capitalization
• Warm, motivational tone
• 800-1200 words
• Mix of WHY and HOW
• Soft CTA + product links

Dan Koe Style (Philosophical)

• Long-form essay (2000+ words)
• Personal storytelling opener
• Named frameworks ("The Pyramid Principle")
• Deep teaching, not just tactics
• Newsletter CTA

Common Mistakes to Avoid

• Short articles under 500 words
• Facts without story/emotion
• No clear sections or headers
• No objection handling
• No immediate wins section
• No CTA
• Generic AI-sounding language
• Em dashes (—) everywhere
• Excessive emojis
• Pasting tweet URLs instead of using Insert menu

Browser Automation (agent-browser)

Prerequisites

• clawd browser running on CDP port 18800
• Logged into X on the browser

Navigate to Article Editor

# Open new article
agent-browser --cdp 18800 navigate "https://x.com/compose/article"

# Take snapshot to see current state
agent-browser --cdp 18800 snapshot

Paste Content

# Put content in clipboard
cat article.txt | pbcopy

# Click content area, select all, paste
agent-browser --cdp 18800 click '[contenteditable="true"]'
agent-browser --cdp 18800 press "Meta+a"
agent-browser --cdp 18800 press "Meta+v"

Upload Cover Image

# Upload to file input
agent-browser --cdp 18800 upload 'input[type="file"]' /path/to/cover.png

# Wait for Edit media dialog, click Apply
agent-browser --cdp 18800 snapshot | grep -i apply
agent-browser --cdp 18800 click @e5  # Apply button ref

Publish

# Find and click Publish button
agent-browser --cdp 18800 snapshot | grep -i publish
agent-browser --cdp 18800 click @e35  # Publish button ref

# Confirm in dialog
agent-browser --cdp 18800 click @e5   # Confirm

Cleanup (Important!)

# Close tab after publishing
agent-browser --cdp 18800 tab list
agent-browser --cdp 18800 tab close 1

Troubleshooting: Stale Element Refs

If clicks fail due to stale refs, use JS evaluate:

agent-browser --cdp 18800 evaluate "(function() { 
  const btns = document.querySelectorAll('button'); 
  for (let btn of btns) { 
    if (btn.innerText.includes('Publish')) { 
      btn.click(); 
      return 'clicked'; 
    } 
  } 
  return 'not found'; 
})()"

Content Preparation Script

Convert Markdown to X-Friendly Format

# scripts/format-for-x.sh
#!/bin/bash
# Converts markdown to X Articles format

INPUT="$1"
OUTPUT="${2:-${INPUT%.md}-x-ready.txt}"

cat "$INPUT" | \
  # Remove markdown headers, keep text
  sed 's/^## /\n/g' | \
  sed 's/^### /\n/g' | \
  sed 's/^# /\n/g' | \
  # Remove markdown bold/italic
  sed 's/\*\*//g' | \
  sed 's/\*//g' | \
  # Remove em dashes
  sed 's/ — /: /g' | \
  sed 's/—/:/g' | \
  # Join lines within paragraphs (keeps blank lines as separators)
  awk 'BEGIN{RS=""; FS="\n"; ORS="\n\n"} {gsub(/\n/, " "); print}' \
  > "$OUTPUT"

echo "Created: $OUTPUT"

Pre-Publish Checklist

• [ ] Hook grabs attention in first line
• [ ] Objections addressed early
• [ ] Step-by-step with time estimates
• [ ] Immediate wins section included
• [ ] CTA at the end
• [ ] No em dashes (—)
• [ ] Sentences joined on single lines
• [ ] Cover image 5:2 aspect ratio
• [ ] Embeds referenced as "see below"
• [ ] Proofread for AI-sounding language

Tweetable Quote Patterns

For promoting your article:

Result + Cost:

I gave an AI agent full access to my MacBook. It checks email, manages calendar, pushes code. Costs $20/month. A VA costs $2000.

You Don't Need X:

You don't need a Mac Mini. You don't need a server. I'm running my AI agent on an old MacBook Air from a drawer.

Gap Warning:

The gap between 'has AI agent' and 'doesn't' is about to get massive. I set mine up in 15 minutes.

Urgency:

Most people will bookmark this and never set it up. Don't be most people. The window is closing.

Example Workflow

1. Write article in markdown with clear sections 2. Run format script to convert to X-friendly plain text 3. Generate cover image with DALL-E (1792x716 or 5:2 ratio) 4. Open X article editor via browser automation 5. Paste content and add section headers manually in editor 6. Upload cover image via file input 7. Add inline images at section breaks 8. Insert embeds (they'll appear at bottom) 9. Preview and proofread 10. Publish 11. Post promotional tweet with hook + article link

Related Skills

• bird - X/Twitter CLI for posting tweets
• de-ai-ify - Remove AI jargon from text
• ai-pdf-builder - Generate PDFs (for lead magnets)

---

Built by @NextXFrontier

Viral X Article Patterns

Quick reference for proven patterns from top performers.

Top Performers Analyzed

Hook Templates

Insecurity/FOMO

everyone's talking about [X]... and you're sitting there wondering if you missed the window

Big Opportunity

this is the biggest opportunity of our lifetime. here's why:

News Hook

[Company] just [action]. Here's what it means for you:

RIP Pattern

RIP [profession]. This AI tool will [action] in seconds.

WTF Pattern

WTF!! This AI Agent just [amazing thing]. Here's how:

We're Cooked

We're cooked. This AI just [did X]. Here's how it works:

Personal Story

When I was young, I was always drawn to [X]...

Confession

I'll be honest: [vulnerable admission]. But then I discovered [solution].

Section Templates

Objection Handling

most people won't set this up.
they think it's technical.
you don't need to be a developer.
ANYONE can do this.

Step-by-Step with Time

step 1: get a free server (5 min)
step 2: install the software (2 min)
step 3: run the wizard (10 min)
total time: 17 minutes

Immediate Wins

your first 3 wins (next 5 minutes):

win 1: [copy-paste command]
win 2: [copy-paste command]
win 3: [copy-paste command]

Cost Comparison

what this costs: $20/month
what a VA costs: $2000/month
what you get: 24/7 availability, no training, infinite patience

Urgency Close

the window.
most people will bookmark this and never do it.
don't be most people.
the gap between 'has X' and 'doesn't' is about to get massive.

CTA Templates

Hard CTA (Lead Magnet)

RT + follow + reply 'SETUP' and I'll DM you the cheat sheet

Soft CTA

If you set this up, let me know how it goes. I love seeing what people build.

Simple CTA

Feel free to like and RT if this helped. See you in the next one.

Newsletter CTA

I write about [topic] every week. Subscribe to get it in your inbox:
[link]

Writing "Legos" (Building Blocks)

Use these anywhere in your article:

1. Pain point - State a relatable problem 2. Example - Concrete illustration 3. Personal story - Your experience 4. Statistic - Numbers add credibility 5. Metaphor - Makes abstract concrete 6. Quote - Authority or inspiration 7. Reframe - New perspective on old idea 8. What/How/Why - Question structure

Formatting Rules

Do

• Clear H2 section headers
• Bullet/numbered lists
• Bold key phrases
• Do ✅ / Don't ❌ lists
• Subheadings every 3-5 paragraphs

Don't

• Wall of text
• No headers
• Excessive emojis
• Em dashes everywhere
• Generic AI language

Word Count Guidelines

Tweetable Quote Formulas

Result + Cost

[I did X]. [Result]. Costs $[small]. A [alternative] costs $[big].

You Don't Need X

You don't need [expensive thing]. You don't need [complex thing]. I'm doing [amazing result] with [simple thing].

Gap Warning

The gap between '[has thing]' and '[doesn't]' is about to get massive. I set mine up in [short time].

Most People Won't

Most people will bookmark this and never [action]. Don't be most people. The window is closing.

Named Frameworks (Dan Koe Style)

Give your concepts memorable names:

• "Inner Album of Greatest Hits" (your 8-10 best ideas)
• "The Micro Story" (problem → amplify → solution)
• "The Pyramid Principle" (answer-first, then support)
• "Cross Domain Synthesis" (connect different fields)

Having named frameworks makes your content quotable and shareable.