How do I install the X Post skill?

Run npx skillmds@latest add win4r/x-post in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is X Post safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with X Post?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is X Post free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published X Post?

win4r (@win4r) published this skill. Their other Agent Skills are listed on their SkillMD profile.

X Post by win4r — Agent Skill

Name: X Post
Author: win4r

File contents

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

Capture: screencapture -w ~/.claude/skills/x-post/screenshots/temp.png
Reply: python x-post.py reply-media "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

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

---name: x-postdescription: 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 SkillPost content to X (formerly Twitter) including text tweets, media posts, and threads.## Setup CheckIf credentials are not configured, guide the user:```bashcd ~/.claude/skills/x-post && cp .env.example .env# User must edit .env with their X API credentialscd ~/.claude/skills/x-post && pip install -r requirements.txt```## CommandsAll commands run from the skill directory.### Post a text tweet```bashcd ~/.claude/skills/x-post && python x-post.py tweet "Your tweet text here"```### Post with media (image/video)```bashcd ~/.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:```bashcd ~/.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```bashcd ~/.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> <screenshot> "caption"### Continue a named thread```bashcd ~/.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```bashcd ~/.claude/skills/x-post && python x-post.py snap "Your caption"```User will be prompted to click the window to capture.### View history```bashcd ~/.claude/skills/x-post && python x-post.py historycd ~/.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 Post1. Help craft content within character limits2. Run the appropriate command from the skill directory3. Share the resulting tweet URL with them4. If starting a thread they may want to continue later, use `--name` to track it

Frequently asked questions

X Post