X/Twitter Thread Generator

Generate a copy-pastable X thread from any content source - blog posts, articles, PDFs, URLs, or plain text.

Usage: $ARGUMENTS

Process:

1. Parse Input Arguments

   • Extract content input and optional language parameter
   • Examples:
     • 2025-10-06-my-post (slug only, default English)
     • 2025-10-06-my-post ja (slug with Japanese)
     • path/to/article.md (file path)
     • https://myblog.com/post (URL)
     • docs/whitepaper.pdf en (PDF with language)

2. Universal Input Detection

   If input looks like a file path (contains / or file extension):

   • Use Read tool to check if file exists
   • Detect format by extension:
     • .md / .mdx → Parse markdown with frontmatter (extract title, description, body, metadata)
     • .pdf → Inform user PDF parsing is limited, suggest converting to markdown first
     • .docx → Inform user DOCX parsing is limited, suggest converting to markdown first
     • .html → Read and extract main content, strip HTML tags
     • .txt → Read as plain text
     • .json → Parse JSON and extract relevant fields
   • Extract: title, description, body content, metadata

   If input looks like a URL (starts with http:// or https://):

   • Use WebFetch tool to retrieve the page
   • Prompt: "Extract the main article content, title, and description from this page"
   • Parse and clean the text

   If input is a slug (no / and no protocol):

   • Search codebase using Glob: **/*${input}*.md
   • Common patterns to check:
     • src/content/blog/posts/{en,ja}/*${input}*.md
     • content/blog/*${input}*.md
     • posts/*${input}*.md
     • blog/*${input}*.md
   • If language specified, prioritize matching language folder
   • Use Read tool to parse markdown file with frontmatter

3. Determine Language (default: English):

   • If user explicitly specifies "ja" → Japanese
   • If user explicitly specifies "en" → English
   • If file path contains /ja/ → Japanese
   • If content appears to be in Japanese → Japanese
   • Otherwise → English

4. Generate THREE versions in the target language:

   Version 1: Thread (5-8 posts)

   • Professional and engaging tone
   • Break into digestible posts (max 280 chars each)

   Version 2: Single Long (Premium)

   • Structured format with clear sections
   • For Japanese: Use 【brackets】: 【とは】【誰のため】【主な特徴】【次にすべきこと】
   • For English: Use headers: What it is: Who it's for: Key features: What to do next:

   Version 3: Single Short (~280 chars)

   • Concise announcement
   • 2-3 key benefits with emojis
   • Links and hashtags

5. Display all versions to the user in terminal:

   • Show thread posts with character counts
   • Show single long version
   • Show single short version
   • Format for easy copy-pasting

6. Create tri-format HTML preview file using Write tool:

   • IMPORTANT: Check if file exists first: ls -la x-thread-[LANG].html 2>&1
   • If file exists, use Read tool first (even just 1 line): Read('x-thread-[LANG].html', limit=1)
   • Then use Write tool to create/update: x-thread-[LANG].html in user's current directory
   • Include THREE tabs with tab switcher UI:
     • Tab 1: Thread - 5-8 posts with individual "Copy Post" buttons
     • Tab 2: Single Long - Structured format with sections, one "Copy" button
     • Tab 3: Single Short - Concise version (~280 chars), one "Copy" button
   • Use X branding (black theme)
   • Tab switcher at top for easy navigation
   • Use Bash tool to open: open x-thread-[LANG].html && open https://x.com/compose/post

---

X Thread Guidelines

Thread Structure (5-8 tweets):

1. Hook Tweet (Tweet 1/X)

   • Grab attention with a contrarian statement, stat, or bold claim
   • Don't give away everything - create curiosity
   • NO hashtags or links in first tweet (better algorithm reach)
   • Max 280 chars including thread indicator

2. Problem/Context Tweets (Tweets 2-3/X)

   • Set up the problem or context
   • Use specific data points from the blog
   • Keep each tweet to ONE idea
   • Max 280 chars each

3. Insight Tweets (Tweets 4-6/X)

   • Share 3-5 key insights from the blog
   • Use bullet points (•) or numbered lists
   • Include specific examples or stats
   • Make each tweet self-contained
   • Max 280 chars each

4. CTA Tweet (Final tweet)

   • Link to the full article
   • Simple CTA: "Read the full guide:" or "Full breakdown:"
   • Can include 2-3 relevant hashtags here
   • Encourage engagement: "What's your take?"

Thread Numbering:

• Include "(1/6)" style numbering in EVERY tweet
• Count MUST be accurate
• Place at the end of each tweet

Character Limits:

• Each post: MAX 280 characters (including thread number)
• Account for URL shortening: URLs = 23 chars on X
• Leave buffer of 10-15 chars for safety