x-post

name	x-post
description	Post to X (Twitter) - tweets, media, threads with history tracking. Use when the user wants to post, tweet, or share something on X/Twitter.

X (Twitter) Posting Skill

Post content to X (formerly Twitter) including text tweets, media posts, and threads.

Setup Check

If credentials are not configured, guide the user:

cd ~/.claude/skills/x-post && cp .env.example .env
# User must edit .env with their X API credentials
cd ~/.claude/skills/x-post && pip install -r requirements.txt

Commands

All commands run from the skill directory.

Post a text tweet

cd ~/.claude/skills/x-post && python x-post.py tweet "Your tweet text here"

Post with media (image/video)

cd ~/.claude/skills/x-post && python x-post.py media /absolute/path/to/image.jpg "Your tweet text"

Post a thread (multiple tweets)

Create a temp JSON file with array of tweets, then:

cd ~/.claude/skills/x-post && python x-post.py thread /path/to/thread.json --name "thread-name"

Thread JSON format: ["First tweet", "Second tweet", "Third tweet"]

Reply to a tweet by ID

cd ~/.claude/skills/x-post && python x-post.py reply <tweet_id> "Your reply"
cd ~/.claude/skills/x-post && python x-post.py reply-media <tweet_id> /path/to/image.jpg "Your reply"

Reply with screenshot

1. Capture: screencapture -w ~/.claude/skills/x-post/screenshots/temp.png
2. Reply: python x-post.py reply-media <tweet_id> "caption"

Continue a named thread

cd ~/.claude/skills/x-post && python x-post.py continue "thread-name" "Next tweet"
cd ~/.claude/skills/x-post && python x-post.py continue-media "thread-name" /path/to/image.jpg "Next tweet"

Screenshot terminal and tweet

cd ~/.claude/skills/x-post && python x-post.py snap "Your caption"

User will be prompted to click the window to capture.

View history

cd ~/.claude/skills/x-post && python x-post.py history
cd ~/.claude/skills/x-post && python x-post.py threads

Guidelines

• Character limit: 280 chars (Premium users may have extended limits)
• Media: JPG, PNG, GIF, MP4 supported
• Thread naming: Use --name "name" to track threads for later continuation
• Tweet IDs: From https://x.com/user/status/1234567890 the ID is 1234567890

When User Asks to Post

1. Help craft content within character limits
2. Run the appropriate command from the skill directory
3. Share the resulting tweet URL with them
4. If starting a thread they may want to continue later, use --name to track it