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:

• 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)

• 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

• 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

• 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

• 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

• 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):

• 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

• 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

• 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

• 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