skills.rest
Junkfooooood
JunkfoooooodCOMMUNITY
Explore all skills by this author →
GitHub

xurl

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API normally requires writing custom HTTP clients, managing OAuth flows, and parsing raw responses. This Skill wraps the official xurl CLI so an agent can post, search, reply, 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 posts about your product launch, like the top results, 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 a tweet from the command line?▼

Use the xurl CLI with the command "xurl post \"Your message\"" after completing one-time OAuth setup. You can attach media by first running "xurl media upload photo.jpg" and passing the returned ID with --media-id.

How do I upload images or videos to X with xurl?▼

Run "xurl media upload path/to/file" and xurl auto-detects the media type. Videos require server-side processing, so check readiness with "xurl media status MEDIA_ID" or "--wait" before attaching the media ID to a post.

Does xurl support multiple X accounts or apps?▼

Yes, xurl stores isolated credentials per app in ~/.xurl. Switch apps with "xurl auth default APP" or per-request with "--app NAME", and select among multiple accounts using "-u/--username".

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 registered app.

Can xurl access any X API v2 endpoint directly?▼

Yes, beyond shortcut commands xurl supports raw curl-style requests such as "xurl /2/users/me" or "xurl -X POST /2/tweets -d '{...}'". Streaming endpoints like /2/tweets/search/stream are auto-detected or forced with -s.

Related Skills

Explore More Marketing & Sales Skills→
AtlasOmniaAtlasOmnia
115

xurl

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

Community
Intermediate
abbieemayabbieemay

reddit-insights

Analyze Reddit content with semantic search to extract insights and sentiment.

Community
Advanced
orthogonal-shorthogonal-sh
12

social-listening

Aggregate real-time social mentions of brands and topics across platforms.

Official
Intermediate
matthew-johnsonmatthew-johnson

duckduckgo-search

Search DuckDuckGo for text, news, images, and videos without API keys.

Community
Intermediate