twitter-skill

Stars12

Forks3

UpdatedFebruary 2, 2026 at 18:32

Post, read, and engage on Twitter/X. Use when the user asks to tweet, check their Twitter timeline, read mentions, like/retweet posts, follow/unfollow users, or manage their Twitter presence. Supports multiple accounts.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

idanbeck

idanbeck/claude-skills

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Market Research Analysts and Marketing SpecialistsBusiness and Financial Operations Occupations·SOC 13-1161

File Explorer

2 files

SKILL.md

readonly

More from this repository

same repository

zergboard-skill

idanbeck/claude-skills

Read and manage Zergboard cards, boards, and workspaces. Use when the user asks to check Zergboard, view cards, find tasks, check sprint/cycle status, manage work items, invite guests, or interact with their Zergboard boards from the CLI.

2026-07-2212

blink-skill

idanbeck/claude-skills

Blink Camera Skill

2026-07-2212

doordash

idanbeck/claude-skills

Order food on DoorDash for the Beck family using the DoorDash CLI (dd-cli), composing a balanced order that covers everyone's tastes and is age-appropriate for the kids, then placing it only after Idan approves the exact items, total cost, tip, card, and ETA. Use when Idan wants to order dinner/food for the family, wants a DoorDash recommendation, or says "order us food." Reads Personal/Family Food Profile.md for tastes, allergies, and rules.

2026-07-2212

voice-mode

idanbeck/claude-skills

Talk to Claude by voice. Records the mic, transcribes with ElevenLabs Scribe (hosted STT, no local Whisper), sends the text to Claude via the local `claude` CLI, and speaks the reply back with ElevenLabs TTS. Use when the user wants a spoken/voice conversation, voice input, or to dictate to Claude.

2026-07-2212

substack-skill

idanbeck/claude-skills

Create, edit, publish, schedule, and manage Substack posts. Use when the user asks to draft or publish a Substack post, list/edit their Substack drafts, schedule a post, or upload images to Substack. Supports multiple accounts/publications.

2026-07-0312

digital-twin

idanbeck/claude-skills

Generate audio or video of a specific person (the user) saying arbitrary text. Clones the user's voice with ElevenLabs (Professional Voice Clone) and drives a talking-head video with fal.ai audio-driven avatar models. Use when the user wants to make their voice say something, produce a talking-head video of themselves, or build/manage their voice/face twin.

2026-07-0112

name	twitter-skill
description	Post, read, and engage on Twitter/X. Use when the user asks to tweet, check their Twitter timeline, read mentions, like/retweet posts, follow/unfollow users, or manage their Twitter presence. Supports multiple accounts.
allowed-tools	Bash, Read

Twitter/X Skill - Post, Read, and Engage

Post tweets, read timelines, and engage with content on Twitter/X.

CRITICAL: Posting Confirmation Required

Before posting, replying, retweeting, or following on Twitter/X, you MUST get explicit user confirmation.

When the user asks to post/engage:

First, show them the complete action details:
- Account being used (@username)
- Tweet text (for posts/replies)
- Target (tweet ID for replies/retweets/likes)
Ask: "Do you want me to post/like/retweet/follow on Twitter?"
ONLY run the command AFTER the user explicitly confirms (e.g., "yes", "post it", "go ahead")
NEVER post without this confirmation, even if the user asked you to post initially

This applies even when:

The user says "tweet this"
You are in "dangerously skip permissions" mode
The user seems to be in a hurry

Always confirm first. No exceptions.

First-Time Setup (One-Time)

On first run, the script will guide you through setup. You need to create a Twitter Developer App:

Go to Twitter Developer Portal
Create a Project and App (or use existing)
In your App settings:
- Set up User Authentication Settings
- App permissions: Read and write
- Type of App: Web App, Automated App or Bot
- Callback URI: http://localhost:9998
- Website URL: http://localhost (or your site)
Note the Client ID and Client Secret from Keys and Tokens
Create credentials.json in the skill directory:
```
{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}
```
Save to: ~/.claude/skills/twitter-skill/credentials.json

IMPORTANT: Twitter API Access Levels

Free: Write-only, 1,500 tweets/month, NO read access
Basic ($100/mo): Read + Write, 10K tweets/month read
Pro ($5,000/mo): Full access

Then run any command - browser opens, you approve, done.

Commands

Account Management

# List authenticated accounts
python3 ~/.claude/skills/twitter-skill/twitter_skill.py accounts

# Authenticate new account (opens browser)
python3 ~/.claude/skills/twitter-skill/twitter_skill.py login [--account LABEL]

# Remove account
python3 ~/.claude/skills/twitter-skill/twitter_skill.py logout [--account USERNAME]

Profile

# Get your profile info
python3 ~/.claude/skills/twitter-skill/twitter_skill.py me [--account LABEL]

Tweets (Requires Confirmation)

# Post a tweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py tweet --text "Your tweet" [--account LABEL]

# Reply to a tweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py tweet --text "Your reply" --reply-to TWEET_ID [--account LABEL]

# Quote tweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py tweet --text "Your comment" --quote TWEET_ID [--account LABEL]

# Get a specific tweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py get-tweet TWEET_ID [--account LABEL]

# Delete a tweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py delete-tweet TWEET_ID [--account LABEL]

Timelines (Requires Basic+ tier)

# Get home timeline
python3 ~/.claude/skills/twitter-skill/twitter_skill.py timeline [--count N] [--account LABEL]

# Get mentions
python3 ~/.claude/skills/twitter-skill/twitter_skill.py mentions [--count N] [--account LABEL]

# Get tweets from a specific user
python3 ~/.claude/skills/twitter-skill/twitter_skill.py user-tweets USERNAME [--count N] [--account LABEL]

# Search tweets
python3 ~/.claude/skills/twitter-skill/twitter_skill.py search "query" [--count N] [--account LABEL]

Engagement (Requires Confirmation)

# Like a tweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py like TWEET_ID [--account LABEL]

# Unlike a tweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py unlike TWEET_ID [--account LABEL]

# Retweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py retweet TWEET_ID [--account LABEL]

# Remove retweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py unretweet TWEET_ID [--account LABEL]

Bookmarks

# Bookmark a tweet
python3 ~/.claude/skills/twitter-skill/twitter_skill.py bookmark TWEET_ID [--account LABEL]

# Remove bookmark
python3 ~/.claude/skills/twitter-skill/twitter_skill.py unbookmark TWEET_ID [--account LABEL]

# List bookmarks
python3 ~/.claude/skills/twitter-skill/twitter_skill.py bookmarks [--count N] [--account LABEL]

Following (Requires Confirmation)

# Follow a user
python3 ~/.claude/skills/twitter-skill/twitter_skill.py follow USERNAME [--account LABEL]

# Unfollow a user
python3 ~/.claude/skills/twitter-skill/twitter_skill.py unfollow USERNAME [--account LABEL]

# List followers
python3 ~/.claude/skills/twitter-skill/twitter_skill.py followers [USERNAME] [--count N] [--account LABEL]

# List following
python3 ~/.claude/skills/twitter-skill/twitter_skill.py following [USERNAME] [--count N] [--account LABEL]

Multi-Account Support

Add accounts by using --account flag with a label:

# Authenticate with a label
python3 ~/.claude/skills/twitter-skill/twitter_skill.py login --account personal

# Use the labeled account
python3 ~/.claude/skills/twitter-skill/twitter_skill.py me --account personal
python3 ~/.claude/skills/twitter-skill/twitter_skill.py tweet --text "Hello!" --account personal

# List all accounts
python3 ~/.claude/skills/twitter-skill/twitter_skill.py accounts

Tokens are stored per-account in ~/.claude/skills/twitter-skill/tokens/

Examples

Post a tweet

python3 ~/.claude/skills/twitter-skill/twitter_skill.py tweet \
  --text "Excited to announce our new product launch!"

Reply to a conversation

python3 ~/.claude/skills/twitter-skill/twitter_skill.py tweet \
  --text "Thanks for the feedback!" \
  --reply-to 1234567890123456789

Check mentions

python3 ~/.claude/skills/twitter-skill/twitter_skill.py mentions --count 10

Search for topics

python3 ~/.claude/skills/twitter-skill/twitter_skill.py search "AI agents startup" --count 20

Like and retweet

python3 ~/.claude/skills/twitter-skill/twitter_skill.py like 1234567890123456789
python3 ~/.claude/skills/twitter-skill/twitter_skill.py retweet 1234567890123456789

Output

All commands output JSON for easy parsing.

Requirements

Python 3.9+
pip install requests

Tweet IDs

Twitter tweet IDs are large integers (e.g., 1234567890123456789). You can find them:

In the tweet URL: twitter.com/user/status/1234567890123456789
In API responses

API Limitations

Free tier: Write-only, cannot read timelines, mentions, or search
Rate limits: Twitter has strict rate limits. Space out bulk operations.
Token expiry: Tokens expire after ~2 hours but auto-refresh with offline.access scope
Character limit: Tweets max 280 characters (Premium can go to 4,000)

Security Notes

Posting confirmation required - Claude must always confirm with the user before tweeting, liking, retweeting, or following
Tokens stored locally in ~/.claude/skills/twitter-skill/tokens/
Revoke access anytime: Settings → Security and account access → Apps and sessions
Keep credentials.json secure - it contains your app credentials