Efficient Publisher X

Generate copy-pastable X/Twitter threads in three formats (thread, long post, short post) from any content source, with character counting, HTML preview, and one-click copy.

When to Use This Command

Run this command when you need to promote content on X/Twitter with optimized formatting across multiple post styles.

• You published a blog post and want to create an engaging X thread to drive traffic
• You need three content variations: a multi-post thread, a long-form single post, and a short announcement
• You want accurate character counting including thread numbering and URL shortening
• You need a branded HTML preview with tabbed navigation for easy copying

Use it also when:

• You want to generate X content in Japanese with proper bracket formatting
• You need to create threads from PDFs, URLs, or markdown files

Quick Start

Copy
# .claude/commands/efficient-publisher-x.md
name: efficient-publisher-x
description: Generate X/Twitter threads in 3 formats
arguments:
  input: Blog slug, file path, or URL

Copy
# Generate X thread from a blog post slug
claude efficient-publisher-x "my-post-slug en"

Expected output:
X Thread Generated (3 formats):

Thread (6 posts):
  1/6: Hook tweet (247 chars)
  2/6: Problem setup (261 chars)
  ...
  6/6: CTA with link (198 chars)

Single Long: 1,842 chars (Premium format)
Single Short: 267 chars

Preview: x-thread-en.html (3 tabs)
Opening X composer...

Core Concepts

Concept	Description
Thread	5-8 connected posts with numbering (e.g., 1/6, 2/6)
Single Long	Premium-length post with structured sections
Single Short	Concise ~280 character announcement post
Hook Tweet	First tweet designed to grab attention and create curiosity
CTA Tweet	Final tweet with article link and engagement prompt

Three Format Strategy:
  Source ──> Parse ──┬──> Thread (5-8 tweets, 280 chars each)
                    ├──> Long Post (structured, Premium)
                    └──> Short Post (~280 chars, concise)
                              │
                              v
                    HTML Preview (3 tabs + copy buttons)

Configuration

Parameter	Default	Description
input	required	Blog slug, file path, or URL
language	en	Target language: en or ja
thread-length	5-8	Number of posts in the thread
output	x-thread-{lang}.html	Output preview file
open-browser	true	Auto-open preview and X composer

Best Practices

1. No hashtags in the hook tweet -- X's algorithm gives better reach to first tweets without hashtags or links. Save those for the CTA (final) tweet.

2. Verify character counts include thread numbering -- Each (X/Y) suffix consumes 5-7 characters. The generator accounts for this, but verify in the preview.

3. Account for URL shortening -- X shortens all URLs to 23 characters regardless of actual length. The generator uses this in its character calculations.

4. Use Japanese bracket format for JA threads -- Japanese threads use bracket section headers: (toha), (dare no tame), (shu na tokuchou) for structured readability.

5. Make each tweet self-contained -- While tweets form a thread, each individual tweet should make sense on its own since users may see them out of context.

Common Issues

1. Thread exceeds 280 characters per tweet -- If auto-generated tweets are too long, the content may need tighter summarization. Edit the source content to be more concise.

2. Preview file already exists -- The command checks for existing files before writing. If a previous preview exists, it reads it first to avoid data loss.

3. X composer does not pre-fill content -- X does not support pre-filling compose from external sources. Use the copy buttons in the HTML preview to paste manually.