OpenSkillIndex← back to search
claude-code

Awesome-omni-skill x-post

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

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/content-media/x-post" ~/.claude/skills/diegosouzapw-awesome-omni-skill-x-post && rm -rf "$T"
manifest: skills/content-media/x-post/SKILL.md
source content

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 && npm install

Commands

All commands run from the skill directory.

Post a text tweet

cd ~/.claude/skills/x-post && node x-post.js tweet "Your tweet text here"

Post with media (image/video)

cd ~/.claude/skills/x-post && node x-post.js 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 && node x-post.js 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 && node x-post.js reply <tweet_id> "Your reply"
cd ~/.claude/skills/x-post && node x-post.js 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: node x-post.js reply-media <tweet_id> <screenshot> "caption"

Continue a named thread

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

Screenshot terminal and tweet

cd ~/.claude/skills/x-post && node x-post.js snap "Your caption"

User will be prompted to click the window to capture.

View history

cd ~/.claude/skills/x-post && node x-post.js history
cd ~/.claude/skills/x-post && node x-post.js 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