skills.rest
AvaTar-ArTs
AvaTar-ArTsCOMMUNITY
Explore all skills by this author →
GitHub

xurl

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

Updated Jul 10, 2026
Search Tags:#automation#social media#oauth#cli#twitter#posting#x api
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill xurl-avatar-arts
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/social-media/xurl
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill xurl-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API normally requires writing custom HTTP clients, managing OAuth flows, and handling token refresh manually. This Skill wraps the official xurl CLI so an agent can post, search, read timelines, send DMs, upload media, and call any v2 endpoint directly with structured JSON output. ## Core Features & Use Cases - Full posting workflow: Create posts, replies, quotes, and threads, attach uploaded images or videos, and delete posts by ID or URL. - Reading and engagement: Search posts, read timelines and mentions, like, repost, bookmark, follow, block, mute, and send direct messages. - Raw v2 API access: Run curl-style requests against any X API v2 endpoint, including streaming endpoints, with multi-app and multi-account credential support. - Use Case: Ask the agent to search X for recent posts about your product, like the most relevant ones, and reply to one with a prepared message — all executed through xurl commands returning JSON. ## Quick Start Ask the agent to verify xurl is installed and authenticated with "xurl auth status", then have it 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 the xurl CLI with "xurl post \"your message\"" after completing one-time OAuth setup. You can attach media by uploading first with "xurl media upload photo.jpg" and passing the returned media ID via --media-id.

How do I search X posts and read timelines with xurl?▼

Run "xurl search \"query\" -n 10" for post search, "xurl timeline -n 20" for your home timeline, and "xurl mentions -n 10" for mentions. All commands return JSON matching the X API v2 response structure.

Does xurl support multiple X accounts or apps?▼

Yes. Each registered app has isolated credentials and tokens. Switch with "xurl auth default APP USER" or per-request with --app and -u/--username flags. App registration and OAuth must be done manually by the user outside the agent session.

Why do I get auth errors after a successful OAuth flow with xurl?▼

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

Can xurl upload videos and images to X?▼

Yes, "xurl media upload file.mp4" handles images and video with auto type detection. Videos require server-side processing, so poll with "xurl media status MEDIA_ID" or use --wait before attaching the media ID to a post.

What are the limitations of using xurl for X API access?▼

X enforces per-endpoint rate limits, with tighter limits on write actions, and meaningful API usage typically requires a paid plan. Many failures such as client-forbidden or CreditsDepleted stem from plan or enrollment issues rather than the CLI itself.

Related Skills

Explore More Marketing & Sales Skills→
NousResearchNousResearch
239.1k

xurl

Interact with the X/Twitter API via the official xurl CLI for posting, searching, and messaging.

Official
Intermediate
vivy-yivivy-yi
363

performance-tracking

Analyzes social media performance metrics to inform content strategy.

Community
Advanced
nexscope-ainexscope-ai
632

brand-monitoring

Monitor brand mentions and sentiment across social media platforms.

Official
Intermediate
humanerd-drewhumanerd-drew
2

external-tool-evaluation

Evaluate GitHub repos and external tools for AI agent integration.

Official
Advanced