twitter-automation · davepoon — Claude Code skill: posts, search
twitter-automation — a skill for Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, and OpenCode that connects Twitter/X through Rube MCP (Composio): posts, search, users, bookmarks, lists, and media.
MIT 128 installs ★ 3,785 updated 2026-10-25
npx skills add davepoon/buildwithclaude --skill twitter-automation -a claude-codeWhat twitter-automation does
The skill covers six tool groups: creating and deleting posts, searching recent and archived tweets, user profile lookup, bookmark management, list management, and liking posts. Every workflow starts with TWITTER_USER_LOOKUP_ME because most endpoints require the authenticated user's numeric ID, not a username.
Setting up takes two steps: add https://rube.app/mcp as an MCP server in your client config (no API keys needed at this stage), then run RUBE_MANAGE_CONNECTIONS with toolkit twitter and complete the OAuth flow. The connection must show ACTIVE before any workflow runs.
TWITTER_RECENT_SEARCH covers only the last 7 days; full archive access requires Academic Research or Enterprise credentials from Twitter. Post creation is not idempotent — retrying on a timeout will create a duplicate. Media IDs must be passed as numeric strings, and images and videos/GIFs use separate upload tools.
What it helps with
- publish a post with an attached image or video through an agent
- search tweets by keyword or operator like
from:usernamewithin the last 7 days - bookmark a tweet and retrieve the authenticated user's bookmark list
- look up a user profile by username or numeric ID
- delete a specific post by ID in a scripted workflow
Example prompts for the agent
- Post a tweet saying 'Hello, world!' from my account
- Search for tweets from
@elonmuskin the last 7 days that havehas:media - Show my Twitter bookmarks and add tweet ID
1234567890to them
How to install twitter-automation
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill twitter-automation -a claude-code2Manually: put the files in place
~/.claude/skills/twitter-automation/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/twitter-automation/
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill twitter-automation -a codex2Manually: put the files in place
.agents/skills/twitter-automation/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill twitter-automation -a cursor2Manually: put the files in place
.cursor/skills/twitter-automation/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install davepoon/buildwithclaude plugins/all-skills/skills/twitter-automation2Manually: put the files in place
.github/skills/twitter-automation/SKILL.md1Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill twitter-automation -a gemini-cli2Platform CLI
gemini skills install https://github.com/davepoon/buildwithclaude --path plugins/all-skills/skills/twitter-automationManually: put the files in place
.devin/skills/twitter-automation/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add davepoon/buildwithclaude --skill twitter-automation -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about twitter-automation
How do I install twitter-automation in Claude Code?
Run npx skills add davepoon/buildwithclaude --skill twitter-automation -a claude-code. The skill will then be available at ~/.claude/skills/twitter-automation/SKILL.md.
What does the twitter-automation skill do?
It gives your agent a structured workflow for Twitter/X through Rube MCP (Composio): creating and deleting posts, searching tweets, managing bookmarks and lists, and uploading media. The agent fetches current tool schemas via RUBE_SEARCH_TOOLS before each run.
Does this skill work without a Twitter API key?
You don't provide a Twitter API key directly. Add https://rube.app/mcp as an MCP server, then connect your Twitter account through RUBE_MANAGE_CONNECTIONS with toolkit twitter using the returned OAuth link. Once the connection status is ACTIVE, the skill is ready.
Source text
SKILL.md · MIT
--- name: twitter-automation description: "Automate Twitter/X tasks via Rube MCP (Composio): posts, search, users, bookmarks, lists, media. Always search tools first for current schemas." requires: mcp: [rube] category: social-media --- # Twitter/X Automation via Rube MCP Automate Twitter/X operations through Composio's Twitter toolkit via Rube MCP. **Toolkit docs**: [composio.dev/toolkits/twitter](https://composio.dev/toolkits/twitter) ## Prerequisites - Rube MCP must be connected (RUBE_SEARCH_TOOLS available) - Active Twitter connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `twitter` - Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas ## Setup **Get Rube MCP**: Add `https://rube.app/mcp` as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works. 1. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds 2. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `twitter` 3. If connection is not ACTIVE, follow the returned auth link to complete Twitter OAuth 4. Confirm connection status shows ACTIVE before running any workflows ## Core Workflows ### 1. Create and Manage Posts **When to use**: User wants to create, delete, or look up tweets/posts **Tool sequence**: 1. `TWITTER_USER_LOOKUP_ME` - Get authenticated user info [Prerequisite] 2. `TWITTER_UPLOAD_MEDIA` / `TWITTER_UPLOAD_LARGE_MEDIA` - Upload media [Optional] 3. `TWITTER_CREATION_OF_A_POST` - Create a new post [Required] 4. `TWITTER_POST_LOOKUP_BY_POST_ID` - Look up a specific post [Optional] 5. `TWITTER_POST_DELETE_BY_POST_ID` - Delete a post [Optional] **Key parameters**: - `text`: Post text content (max 280 weighted characters) - `media__media_ids`: Array of media ID strings for attachments - `reply__in_reply_to_tweet_id`: Tweet ID to reply to - `quote_tweet_id`: Tweet ID to quote - `id`: Post ID for lookup/delete **Pitfalls**: - Post text is limited to 280 weighted characters; some characters count as more than one - Posting is NOT idempotent; retrying on timeout will create duplicate posts - Media IDs must be numeric strings, not integers - UPLOAD_LARGE_MEDIA is for videos/GIFs; UPLOAD_MEDIA for images - Always call USER_LOOKUP_ME first to get the authenticated user's ID ### 2. Search Posts **When to use**: User wants to find tweets matching specific criteria **Tool sequence**: 1. `TWITTER_RECENT_SEARCH` - Search recent tweets (last 7 days) [Required] 2. `TWITTER_FULL_ARCHIVE_SEARCH` - Search full archive (Academic access) [Optional] 3. `TWITTER_RECENT_SEARCH_COUNTS` - Get tweet count matching query [Optional] **Key parameters**: - `query`: Search query using Twitter search operators - `max_results`: Results per page (10-100) - `next_token`: Pagination token - `start_time`/`end_time`: ISO 8601 time range - `tweet__fields`: Comma-separated fields to include - `expansions`: Related objects to expand **Pitfalls**: - RECENT_SEARCH covers only the last 7 days; use FULL_ARCHIVE_SEARCH for older tweets - FULL_ARCHIVE_SEARCH requires Academic Research or Enterprise access - Query operators: `from:username`, `to:username`, `is:retweet`, `has:media`, `-is:retweet` - Empty results return `meta.result_count: 0` with no `data` field - Rate limits vary by endpoint and access level; check response headers ### 3. Look Up Users **When to use**: User wants to find or inspect Twitter user profiles **Tool sequence**: 1. `TWITTER_USER_LOOKUP_ME` - Get authenticated user [Optional] 2. `TWITTER_USER_LOOKUP_BY_USERNAME` - Look up by username [Optional] 3. `TWITTER_USER_LOOKUP_BY_ID` - Look up by user ID [Optional] 4. `TWITTER_USER_LOOKUP_BY_IDS` - Batch look up multiple users [Optional] **Key parameters**: - `username`: Twitter handle without @ prefix - `id`: Numeric user ID string - `ids`: Comma-separated user IDs for batch lookup - `user__fields`: Fields to return (description, public_metrics, etc.) **Pitfalls**: - Usernames are case-insensitive but must not include the @ prefix - User IDs are numeric strings, not integers - Suspended or deleted accounts return errors, not empty results - LOOKUP_BY_IDS accepts max 100 IDs per request ### 4. Manage Bookmarks **When to use**: User wants to save, view, or remove bookmarked tweets **Tool sequence**: 1. `TWITTER_USER_LOOKUP_ME` - Get authenticated user ID [Prerequisite] 2. `TWITTER_BOOKMARKS_BY_USER` - List bookmarked posts [Required] 3. `TWITTER_ADD_POST_TO_BOOKMARKS` - Bookmark a post [Optional] 4. `TWITTER_REMOVE_A_BOOKMARKED_POST` - Remove bookmark [Optional] **Key parameters**: - `id`: User ID (from USER_LOOKUP_ME) for listing bookmarks - `tweet_id`: Tweet ID to bookmark or unbookmark - `max_results`: Results per page - `pagination_token`: Token for next page **Pitfalls**: - Bookmarks require the authenticated user's ID, not username - Bookmarks are private; only the authenticated user can see their own - Pagination uses `pagination_token`, not `next_token` ### 5. Manage Lists **When to use**: User wants to view or manage Twitter lists **Tool sequence**: 1. `TWITTER_USER_LOOKUP_ME` - Get authenticated user ID [Prerequisite] 2. `TWITTER_GET_A_USER_S_OWNED_LISTS` - List owned lists [Optional] 3. `TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS` - List memberships [Optional] 4. `TWITTER_GET_A_USER_S_PINNED_LISTS` - Get pinned lists [Optional] 5. `TWITTER_GET_USER_S_FOLLOWED_LISTS` - Get followed lists [Optional] 6. `TWITTER_LIST_LOOKUP_BY_LIST_ID` - Get list details [Optional] **Key parameters**: - `id`: User ID for listing owned/member/followed lists - `list_id`: List ID for specific list lookup - `max_results`: Results per page (1-100) **Pitfalls**: - List IDs and User IDs are numeric strings - Lists endpoints require the user's numeric ID, not username ### 6. Interact with Posts **When to use**: User wants to like, unlike, or view liked posts **Tool sequence**: 1. `TWITTER_USER_LOOKUP_ME` - Get authenticated user ID [Prerequisite] 2. `TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID` - Get liked posts [Optional] 3. `TWITTER_UNLIKE_POST` - Unlike a post [Optional] **Key parameters**: - `id`: User ID for listing liked posts - `tweet_id`: Tweet ID to unlike **Pitfalls**: - Like/unlike endpoints require user ID from USER_LOOKUP_ME - Liked posts pagination may be slow for users with many likes ## Common Patterns ### Search Query Syntax **Operators**: - `from:username` - Posts by user - `to:username` - Replies to user - `@username` - Mentions user - `#hashtag` - Contains hashtag - `"exact phrase"` - Exact match - `has:media` - Contains media - `has:links` - Contains links - `is:retweet` / `-is:retweet` - Include/exclude retweets - `is:reply` / `-is:reply` - Include/exclude replies - `lang:en` - Language filter **Combinators**: - Space for AND - `OR` for either condition - `-` prefix for NOT - Parentheses for grouping ### Media Upload Flow ``` 1. Upload media with TWITTER_UPLOAD_MEDIA (images) or TWITTER_UPLOAD_LARGE_MEDIA (video/GIF) 2. Get media_id from response 3. Pass media_id as string in media__media_ids array to TWITTER_CREATION_OF_A_POST ``` ## Known Pitfalls **Character Limits**: - Standard posts: 280 weighted characters - Some Unicode characters count as more than 1 - URLs are shortened and count as fixed length (23 characters) **Rate Limits**: - Vary significantly by access tier (Free, Basic, Pro, Enterprise) - Free tier: very limited (e.g., 1,500 posts/month) - Check `x-rate-limit-remaining` header in responses **Idempotency**: - Post creation is NOT idempotent; duplicate posts will be created on retry - Implement deduplication logic for automated posting ## Quick Reference | Task | Tool Slug | Key Params | |------|-----------|------------| | Create post | TWITTER_CREATION_OF_A_POST | text | | Delete post | TWITTER_POST_DELETE_BY_POST_ID | id | | Look up post | TWITTER_POST_LOOKUP_BY_POST_ID | id | | Recent search | TWITTER_RECENT_SEARCH | query | | Archive search | TWITTER_FULL_ARCHIVE_SEARCH | query | | Search counts | TWITTER_RECENT_SEARCH_COUNTS | query | | My profile | TWITTER_USER_LOOKUP_ME | (none) | | User by name | TWITTER_USER_LOOKUP_BY_USERNAME | username | | User by ID | TWITTER_USER_LOOKUP_BY_ID | id | | Users by IDs | TWITTER_USER_LOOKUP_BY_IDS | ids | | Upload media | TWITTER_UPLOAD_MEDIA | media | | Upload video | TWITTER_UPLOAD_LARGE_MEDIA | media | | List bookmarks | TWITTER_BOOKMARKS_BY_USER | id | | Add bookmark | TWITTER_ADD_POST_TO_BOOKMARKS | tweet_id | | Remove bookmark | TWITTER_REMOVE_A_BOOKMARKED_POST | tweet_id | | Unlike post | TWITTER_UNLIKE_POST | tweet_id | | Liked posts | TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID | id | | Owned lists | TWITTER_GET_A_USER_S_OWNED_LISTS | id | | List memberships | TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS | id | | Pinned lists | TWITTER_GET_A_USER_S_PINNED_LISTS | id | | Followed lists | TWITTER_GET_USER_S_FOLLOWED_LISTS | id | | List details | TWITTER_LIST_LOOKUP_BY_LIST_ID | list_id | --- *Powered by [Composio](https://composio.dev)*
© davepoon · MIT · davepoon/buildwithclaude
Similar skills
All skills for Automation and no-code: n8n, Zapier, Make →twitter-automation by other authors comes first.