Skip to content
Automation
Skill

/x-twitter

Post tweets, search, read mentions, and check engagement on X (Twitter) via API v2.

From plugin
sutando
36557 skills7 hooks
Install
$ npx -y skills add sonichi/sutando --skill x-twitter --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/x-twitter

Context preview

The summary Claude sees to decide when to auto-load this skill.

Post tweets, search, read mentions, and check engagement on X (Twitter) via API v2.

SKILL.md

x-twitter.SKILL.md
name: x-twitter
description: "Post tweets, search, read mentions, and check engagement on X (Twitter) via API v2."

X (Twitter)

Post, search, read, and monitor X from the command line.

Usage

# Post
python3 skills/x-twitter/x-post.py post "Your tweet text"
python3 skills/x-twitter/x-post.py post "With video" --media /path/to/video.mp4
python3 skills/x-twitter/x-post.py post --reply-to 123456789 "Reply text"

# Search
python3 skills/x-twitter/x-post.py search "sutando agent"
python3 skills/x-twitter/x-post.py search "from:Chi_Wang_" --limit 5

# Read a tweet
python3 skills/x-twitter/x-post.py read 2040817066199195818

# Mentions & timeline
python3 skills/x-twitter/x-post.py mentions
python3 skills/x-twitter/x-post.py timeline

# Engagement (likes, retweets, views)
python3 skills/x-twitter/x-post.py engagement 2040817066199195818

Setup

1. Install Python dependencies (one-time):

   pip3 install requests requests-oauthlib

2. Go to https://developer.x.com and sign in 3. Create a Project + App 4. Generate keys and add to `.env`:

   X_API_KEY=...
   X_API_SECRET=...
   X_ACCESS_TOKEN=...
   X_ACCESS_TOKEN_SECRET=...

Notes

  • Free tier: 500 posts/month, search recent tweets (7 days)
  • Video upload uses chunked upload (supports 4K)
  • Always confirm post content with user before publishing
Ships withsutando

My AI Stand — Realtime by Day, Rewriting Itself by Night. Summon my AI superpower. Voice, vision, screen, meetings, calls when I'm engaged. Learns my patterns, ships its own code when I'm not. Runs across my Macs, interacts with people & their Stands.

Get the whole plugin