Claude-code-startup-skills x-post

Name: x-post
Author: rameerez

Post to X (Twitter) from the command line. Text, images, and video.

install

source · Clone the upstream repo

git clone https://github.com/rameerez/claude-code-startup-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/rameerez/claude-code-startup-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/x-post" ~/.claude/skills/rameerez-claude-code-startup-skills-x-post && rm -rf "$T"

manifest: skills/x-post/SKILL.md

source content

Post to X using the CLI tool at

~/.claude/skills/x-post/x-post.py

Setup

Requires Python packages:

pip install xdk requests_oauthlib

Credentials file at

~/.claude/skills/x-post/x.key

(JSON):

{
  "api_key": "...",
  "api_secret": "...",
  "access_token": "...",
  "access_token_secret": "..."
}

Commands

Post text:

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

Post with image:

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

Post with video:

python ~/.claude/skills/x-post/x-post.py post "Your tweet text" --media /path/to/video.mp4

Check profile:

python ~/.claude/skills/x-post/x-post.py me

Rules

Always show the user the exact tweet text before posting and get confirmation
Never post without explicit user approval
Video uploads use chunked upload (INIT/APPEND/FINALIZE) and may take a minute for processing
The script auto-detects media type from file extension