xitter
Post, read, and search X (Twitter) content using x-cli or the X API v2
Install / Use
npx skills add taracodlabs/aiden --skill xitterInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of xitter
xitter scores 85/100 on our quality scale, 1989th of 2,769 Automation skills we index.
Its SKILL.md is 5.1 KB long, well organised into 10 sections with 5 code examples: a solid amount of guidance for an agent.
It has 843 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so xitter is actively maintained.
- Our last check on 2026-11-05 found the source still online.
- It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit ā read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk ā read a skill before letting an agent act on it.
xitter compared with similar skills
All 4 of these similar skills score higher than xitter; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| xitter (this skill)by taracodlabs | 85 | 843 | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.9k | 8d ago | CLAUDE.md |
Frequently asked questions
- How do I install xitter?
- Run
npx skills add taracodlabs/aiden --skill xitter. The install tabs above show the steps for each supported agent. - Which AI agents does xitter work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is xitter safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is xitter still maintained?
- The repository was last updated about 2 months ago, so xitter is actively maintained.
Skill content
View source on GitHubname: xitter description: Post, read, and search X (Twitter) content using x-cli or the X API v2 category: social version: 1.0.0 origin: aiden license: Apache-2.0 tags: twitter, x, social-media, tweet, post, search, api, x-cli, timeline, mentions
X (Twitter) Automation
Read, post, and search X content using the x-cli command-line tool or the X API v2 directly. Requires X API credentials.
When to Use
- User wants to post a tweet or thread on X
- User wants to search for recent tweets on a topic
- User wants to read their home timeline or mentions
- User wants to fetch tweets from a specific account
- User wants to schedule or automate social media posts
How to Use
1. Set up X API credentials
Register at https://developer.twitter.com ā Create Project ā Create App. Get:
API_KEY,API_SECRETACCESS_TOKEN,ACCESS_TOKEN_SECRETBEARER_TOKEN(for read-only app-only auth)
$env:X_BEARER_TOKEN = "your_bearer_token"
$env:X_API_KEY = "your_api_key"
$env:X_API_SECRET = "your_api_secret"
$env:X_ACCESS_TOKEN = "your_access_token"
$env:X_ACCESS_SECRET = "your_access_secret"
2. Search recent tweets (Bearer Token ā no user auth needed)
import requests, os
def search_tweets(query, max_results=10):
headers = {"Authorization": f"Bearer {os.environ['X_BEARER_TOKEN']}"}
params = {
"query": f"{query} -is:retweet lang:en",
"max_results": max_results,
"tweet.fields": "created_at,author_id,public_metrics"
}
resp = requests.get("https://api.twitter.com/2/tweets/search/recent", headers=headers, params=params)
resp.raise_for_status()
for tweet in resp.json().get("data", []):
print(f"⢠{tweet['text'][:120]}")
print(f" {tweet['created_at']} likes={tweet['public_metrics']['like_count']}\n")
search_tweets("Aiden AI agent 2026", max_results=5)
3. Post a tweet (OAuth 1.0a)
import requests, os, time, hashlib, hmac, base64, urllib.parse, uuid
def post_tweet(text):
url = "https://api.twitter.com/2/tweets"
params = {"text": text}
# OAuth 1.0a signature
oauth_params = {
"oauth_consumer_key": os.environ["X_API_KEY"],
"oauth_nonce": uuid.uuid4().hex,
"oauth_signature_method": "HMAC-SHA1",
"oauth_timestamp": str(int(time.time())),
"oauth_token": os.environ["X_ACCESS_TOKEN"],
"oauth_version": "1.0",
}
signing_key = "&".join([urllib.parse.quote(os.environ["X_API_SECRET"], safe=""),
urllib.parse.quote(os.environ["X_ACCESS_SECRET"], safe="")])
base_string = "&".join(["POST", urllib.parse.quote(url, safe=""),
urllib.parse.quote("&".join(f"{k}={v}" for k,v in sorted(oauth_params.items())), safe="")])
signature = base64.b64encode(hmac.new(signing_key.encode(), base_string.encode(), hashlib.sha1).digest()).decode()
oauth_params["oauth_signature"] = signature
auth_header = "OAuth " + ", ".join(f'{k}="{urllib.parse.quote(v, safe="")}"' for k,v in oauth_params.items())
resp = requests.post(url, json=params, headers={"Authorization": auth_header, "Content-Type": "application/json"})
resp.raise_for_status()
print(f"Posted tweet: {resp.json()['data']['id']}")
post_tweet("Hello from Aiden! š¤ #AI #automation")
4. Fetch user timeline
import requests, os
def get_user_timeline(username, max_results=10):
headers = {"Authorization": f"Bearer {os.environ['X_BEARER_TOKEN']}"}
user = requests.get(f"https://api.twitter.com/2/users/by/username/{username}", headers=headers).json()
user_id = user["data"]["id"]
resp = requests.get(
f"https://api.twitter.com/2/users/{user_id}/tweets",
headers=headers,
params={"max_results": max_results, "tweet.fields": "created_at,public_metrics", "exclude": "retweets"}
)
for tweet in resp.json().get("data", []):
print(f"⢠{tweet['text'][:120]}\n {tweet['created_at']}\n")
get_user_timeline("elonmusk", max_results=5)
5. Read mentions
import requests, os
def get_mentions(user_id, max_results=10):
headers = {"Authorization": f"Bearer {os.environ['X_BEARER_TOKEN']}"}
resp = requests.get(
f"https://api.twitter.com/2/users/{user_id}/mentions",
headers=headers,
params={"max_results": max_results, "tweet.fields": "created_at,author_id"}
)
for tweet in resp.json().get("data", []):
print(f"⢠{tweet['text'][:120]}\n {tweet['created_at']}\n")
Examples
"Search for recent tweets about LLM agents"
ā Use step 2 with query "LLM agents".
"Post a tweet saying 'Aiden just automated my morning report'" ā Ask user to confirm before posting, then use step 3.
"Show me the last 10 tweets from a specific account" ā Use step 4 with the target username.
Cautions
- Posting tweets requires user-context OAuth 1.0a ā Bearer Token alone cannot post
- X API free tier limits search results to the last 7 days and 1 request per 15 minutes
- Always ask user for explicit confirmation before posting any tweet on their behalf
- X API rate limits are strict ā cache results locally rather than re-fetching on every call
- Never hardcode API credentials ā always use environment variables
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu ā one CLI, zero API fees.
ruflo
82.0kš The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
39.9kTurn Claude Code into a full game dev studio ā 49 AI agents, 75 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit ā see the Safety scan above for what the skill file itself contains.
