skills.rest
patty-chow
patty-chowCOMMUNITY
Explore all skills by this author →
GitHub

xurl

Post, search, and manage X/Twitter content via the official xurl CLI.

Updated May 28, 2026
Search Tags:#social media#cli#twitter#oauth2#x api#xurl#post automation
One-click install
npx skills add https://github.com/patty-chow/the-stable --skill xurl-patty-chow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/patty-chow/the-stable/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/patty-chow/the-stable --skill xurl-patty-chow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API from an agent session normally requires handling OAuth flows, endpoint URLs, and JSON payloads manually. This Skill wraps the official xurl CLI so an agent can post, search, reply, send DMs, upload media, and call any v2 endpoint with simple commands while keeping credentials out of the conversation. ## Core Features & Use Cases - Full X API coverage: Post, reply, quote, delete, search, like, repost, bookmark, follow, block, mute, and send direct messages, plus raw curl-style access to any X API v2 endpoint. - Media uploads: Upload images and videos, poll processing status, and attach media IDs to posts. - Multi-app and multi-account auth: OAuth 2.0 PKCE with auto-refreshing tokens, isolated per-app credentials, and strict secret-safety rules that forbid reading ~/.xurl or passing inline secrets. - Use Case: Ask the agent to search recent posts about a topic, like the most relevant ones, and reply to one — it runs xurl search, xurl like, and xurl reply, returning structured JSON for each step. ## Quick Start Ask the agent to verify xurl auth status and then post "Hello world" to your X account.

Frequently Asked Questions about xurl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I post to X/Twitter from the command line?▼

Use xurl post followed by your message text, for example xurl post "Hello world!". You can attach media by first running xurl media upload and passing the returned ID with --media-id.

How do I authenticate xurl with the X API?▼

Register your app with xurl auth apps add using your Client ID and Secret, then run xurl auth oauth2 --app your-app to complete the OAuth 2.0 PKCE browser flow. These steps must be done manually by the user, never by the agent, and tokens auto-refresh afterward.

Can xurl access any X API v2 endpoint?▼

Yes, xurl supports raw curl-style access to any v2 endpoint, such as xurl /2/users/me or xurl -X POST /2/tweets -d '{"text":"Hi"}'. Shortcut commands cover common actions, and raw mode handles everything else including streaming endpoints.

Why do xurl commands fail with auth errors after a successful OAuth flow?▼

The token was likely saved to the built-in default app profile, which has no client credentials. Re-run xurl auth oauth2 --app your-app and then xurl auth default your-app so commands use the app that holds the client ID and secret.

Does xurl support uploading videos to X?▼

Yes, run xurl media upload video.mp4 and then poll processing with xurl media status MEDIA_ID or xurl media status --wait. Once processing completes, attach the media ID to a post with --media-id.

Related Skills

Explore More Marketing & Sales Skills→
microsoftmicrosoft
242

entra-app-registration

Register Microsoft Entra ID apps and configure OAuth/MSAL workflows.

Official
Intermediate
claude-office-skillsclaude-office-skills
368

Twitter/X Automation

Automate Twitter/X posting, engagement, analytics, and audience growth via the Twitter API.

Official
Advanced
chekoschekos
5

social-strategy

Generate platform-native social posts and engagement strategies for X, LinkedIn, Mastodon, Instagram, and YouTube.

Community
Basic
gqf2008gqf2008

xurl

Control X API v2 via the official xurl CLI for posting, reading, and searching.

Community
Advanced