twitterTwitter is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when user asks to "search Twitter", "read a tweet", "check my bookmarks", "find mentions", "get tweets from a list", "see who I follow", "extract tweets", or needs programmatic access to X/Twitter for research and information synthesis. Handles reading, searching, bookmarks, lists, and social graph queries.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/integration/twitter-gupsammy-claude-setup-fd52d204/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/twitter, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Twitter / X Research & Extraction
Programmatic access to Twitter/X via bird CLI. Primary use: search, read, extract, and synthesize information.
Core Commands
Reading & Threads
bird read <url-or-id> # Single tweet
bird read <url> --json # JSON output for processing
bird thread <url> # Full conversation thread
bird replies <url> -n 20 # Replies to a tweet
Search
bird search "query" -n 10 # Search tweets
bird search "from:user topic" # User-specific search
bird search "query" --json # JSON for processing
Bookmarks & Likes
bird bookmarks # Your saved tweets
bird bookmarks -n 50 --json # Bulk export
bird likes # Your liked tweets
bird unbookmark <url> # Remove bookmark
Lists
bird lists # Your lists
bird list-timeline <list-id> # Tweets from a list
Social Graph
bird following # Who you follow
bird followers # Who follows you
bird mentions # Tweets mentioning you
Extraction Workflows
Save tweets to file
bird search "topic" -n 50 --json > tweets.json
bird bookmarks --json > bookmarks.json
bird thread <url> --json > thread.json
Synthesize from search
bird search "topic" -n 20 --json > results.json- Read results.json
- Extract key insights, summarize themes
Export bookmarks for review
bird bookmarks -n 100 --json > bookmarks.json- Parse and categorize by topic
- Create summary or reading list
Auth & Troubleshooting
Check auth status:
bird whoami # Current account
bird check # Credential sources
Auth sources (checked in order):
- Browser cookies (Firefox/Chrome)
SWEETISTICS_API_KEYenv var- Explicit
--auth-tokenand--ct0flags
Common issues:
- Rate limits: Wait and retry; reduce
-ncount - Auth expired: Re-login to Twitter in browser, cookies auto-refresh
- No results: Check query syntax; try broader terms
Output Formats
- Default: Human-readable with emoji
--plain: Stable text output, no emoji/color--json: Machine-readable for processing--json-full: Includes raw API response
Always use --json when extracting for synthesis.