How do I install the Interacting With X skill?

Run npx skillmds@latest add just-cameron/interacting-with-x 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 Interacting With X 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 Interacting With X?

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 Interacting With X free to use?

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

Who published Interacting With X?

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

Interacting With X by just-cameron — Agent Skill

Name: Interacting With X
Author: just-cameron

File contents

Interacting with X

Enables agents to operate on X (Twitter) with full interaction capabilities.

Setup

Add to .env:

X_API_KEY=your_api_key
X_API_SECRET=your_api_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret
X_BEARER_TOKEN=your_bearer_token

Get credentials from https://developer.x.com/en/portal/dashboard

Operations

Post a Tweet

# Simple tweet
uv run python .skills/interacting-with-x/scripts/post.py "Hello from Central"

# Thread (multiple tweets chained)
uv run python .skills/interacting-with-x/scripts/post.py --thread "First tweet" "Second tweet" "Third tweet"

# With media
uv run python .skills/interacting-with-x/scripts/post.py --media image.png "Tweet with image"

# Reply to existing tweet
uv run python .skills/interacting-with-x/scripts/post.py --reply-to 1234567890 "Reply text"

Read Timeline/Mentions

# Home timeline
uv run python .skills/interacting-with-x/scripts/read.py timeline

# Mentions
uv run python .skills/interacting-with-x/scripts/read.py mentions

# User's tweets
uv run python .skills/interacting-with-x/scripts/read.py user elonmusk

# Search
uv run python .skills/interacting-with-x/scripts/read.py search "AI agents"

Engage

# Like
uv run python .skills/interacting-with-x/scripts/engage.py like 1234567890

# Retweet
uv run python .skills/interacting-with-x/scripts/engage.py retweet 1234567890

# Follow/unfollow
uv run python .skills/interacting-with-x/scripts/engage.py follow username
uv run python .skills/interacting-with-x/scripts/engage.py unfollow username

Rate Limits

X API has strict rate limits. Pro tier helps but still:

Posts: 100/24h (Pro: 500/24h)
Reads: 100 requests/15min
Likes: 50/24h

Scripts handle rate limiting automatically. See references/api-reference.md for details.

Character Limits

Standard: 280 characters
Pro: 25,000 characters

Scripts auto-detect account type and handle accordingly.

Cross-posting from ATProto

For mirroring Bluesky content to X:

# In your code
from .skills.interacting_with_x.scripts import post

# After posting to Bluesky, cross-post to X
post.create_tweet(text)  # or post.create_thread(texts) for threads

Facets (mentions, links) are automatically converted to X format.

---name: interacting-with-xdescription: Full interaction with X (Twitter) - post, read, reply, like, retweet, follow. Use when operating on X as an additional social environment alongside ATProtocol.---# Interacting with XEnables agents to operate on X (Twitter) with full interaction capabilities.## SetupAdd to `.env`:```X_API_KEY=your_api_keyX_API_SECRET=your_api_secretX_ACCESS_TOKEN=your_access_tokenX_ACCESS_TOKEN_SECRET=your_access_token_secretX_BEARER_TOKEN=your_bearer_token```Get credentials from https://developer.x.com/en/portal/dashboard## Operations### Post a Tweet```bash# Simple tweetuv run python .skills/interacting-with-x/scripts/post.py "Hello from Central"# Thread (multiple tweets chained)uv run python .skills/interacting-with-x/scripts/post.py --thread "First tweet" "Second tweet" "Third tweet"# With mediauv run python .skills/interacting-with-x/scripts/post.py --media image.png "Tweet with image"# Reply to existing tweetuv run python .skills/interacting-with-x/scripts/post.py --reply-to 1234567890 "Reply text"```### Read Timeline/Mentions```bash# Home timelineuv run python .skills/interacting-with-x/scripts/read.py timeline# Mentionsuv run python .skills/interacting-with-x/scripts/read.py mentions# User's tweetsuv run python .skills/interacting-with-x/scripts/read.py user elonmusk# Searchuv run python .skills/interacting-with-x/scripts/read.py search "AI agents"```### Engage```bash# Likeuv run python .skills/interacting-with-x/scripts/engage.py like 1234567890# Retweetuv run python .skills/interacting-with-x/scripts/engage.py retweet 1234567890# Follow/unfollowuv run python .skills/interacting-with-x/scripts/engage.py follow usernameuv run python .skills/interacting-with-x/scripts/engage.py unfollow username```## Rate LimitsX API has strict rate limits. Pro tier helps but still:- Posts: 100/24h (Pro: 500/24h)- Reads: 100 requests/15min- Likes: 50/24hScripts handle rate limiting automatically. See `references/api-reference.md` for details.## Character Limits- Standard: 280 characters- Pro: 25,000 charactersScripts auto-detect account type and handle accordingly.## Cross-posting from ATProtoFor mirroring Bluesky content to X:```python# In your codefrom .skills.interacting_with_x.scripts import post# After posting to Bluesky, cross-post to Xpost.create_tweet(text) # or post.create_thread(texts) for threads```Facets (mentions, links) are automatically converted to X format.

Frequently asked questions

Interacting With X