Twitter/X Content Generator

Generate thread, standalone tweets, and poll from content atoms.

Inputs

You receive from the orchestrator:

• Content atoms (typed and impact-rated)
• Main argument, target audience, primary topic
• Brand voice profile (5-dimension scores or override flag)
• Flags: --brief (1 tweet only), --images (generate image prompts)

References

Load before generating:

• references/platform-specs.md -- character limits, algorithm weights, posting times
• references/hook-formulas.md -- curiosity gap, contrarian, data-driven, question hooks
• references/voice-adaptation.md -- Twitter tone rules (concise, punchy, no hedging)

Platform Rules

Output 1: Thread (8-12 Tweets)

Write to twitter/thread.md.

Thread Structure

1. Hook tweet (tweet 1)

   • Must work as a standalone tweet even if nobody expands the thread
   • Use a curiosity gap OR bold stat from the highest-impact atom
   • End with : or A thread: to signal continuation
   • Never open with "Thread:" or "1/"
   • 71-100 characters is the sweet spot

2. Insight tweets (tweets 2-9)

   • One key point per tweet, drawn from individual atoms
   • Number each tweet for scannability (2/ prefix)
   • Use line breaks between ideas within a single tweet
   • Alternate between stat, insight, contrarian, and howto atoms
   • Insert a visual break every 3-4 tweets: a one-liner quote, a question, or an image suggestion

3. Closing tweet (final tweet)

   • Summarize the main argument in one sentence
   • Include a clear CTA: follow, repost, reply, or bookmark
   • If a link is needed: suggest placing it in a reply to the final tweet (not in the tweet body) to avoid reach suppression
   • For non-Premium accounts, alternatively suggest "link in bio"

Thread Rules

• Each tweet must be under 280 characters
• Thread should flow logically even if individual tweets are read in isolation
• Frame at least 2 tweets as questions or contrarian takes to invite replies (Reply = 27x like)
• Do not repeat the same hook formula twice in one thread

Output 2: Standalone Tweets (3-5)

Write to twitter/standalone-tweet.md.

Generate 3-5 standalone tweets. Each one:

• Captures a single atom and works completely independently
• Uses a different format from the others:
  • Stat tweet: leads with a number or data point
  • Question tweet: asks a thought-provoking question
  • Hot take tweet: bold/contrarian claim that invites debate
  • Tip tweet: one actionable piece of advice
  • Analogy tweet: comparison that makes the concept click
• Stays within the 71-100 character sweet spot when possible (never exceed 280)
• Includes 0-1 hashtags maximum

Engagement Optimization

• Frame for replies, not likes. Questions and contrarian takes generate 27x more algorithmic weight than passive likes.
• Tweets that invite disagreement or personal experience outperform agreement-bait.
• Avoid "Agree?" or "Thoughts?" -- ask a specific question instead.

Output 3: Poll

Write to twitter/poll.md.

Derive one poll from the content's key decision point or debatable topic.

Poll structure:

• Question: specific, not generic (derived from the content's central tension or choice)
• Options: represent real positions; include one surprising/contrarian option
• Context tweet: 1-2 sentences above the poll that frame why this question matters

External Link Warning

Links in tweet bodies receive near-zero reach for non-Premium accounts. Always:

1. Place links in a reply to the main tweet (not the tweet body)
2. Or suggest "Link in bio" with a directional cue
3. Note this in the output so the user understands the trade-off

Image Prompts

If --images flag is set, suggest one hero image for the thread opener:

• Dimensions: 1600x900 (16:9)
• Purpose: visual hook for tweet 1 of the thread
• Include a prompt description for /banana (subject, context, style, composition)

Output Format

Each output file should use this structure:

# Twitter Thread: [Topic]

## Hook Tweet
[tweet text]

## Tweet 2/N
[tweet text]

...

## Closing Tweet
[tweet text]

---
**Posting notes:** [best time, link placement advice, image suggestions]

Brief Mode

If --brief is active, produce only:

• 1 standalone tweet (highest-impact atom)
• Skip thread and poll