skills.rest
GreenyZA
GreenyZACOMMUNITY
Explore all skills by this author →
GitHub

xurl

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

Updated Sep 20, 2026
Search Tags:#social media#oauth#cli#twitter#posting#x api#xurl
One-click install
npx skills add https://github.com/GreenyZA/neo-light --skill xurl-greenyza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/GreenyZA/neo-light/tree/main/.hermes-home/skills/social-media/xurl
Command: npx skills add https://github.com/GreenyZA/neo-light --skill xurl-greenyza

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the X (Twitter) API from an agent session normally requires writing custom HTTP clients, handling OAuth flows, and parsing raw responses. This Skill wraps the official xurl CLI so an agent can post, search, reply, like, repost, send DMs, and upload media with simple commands that return structured JSON. ## Core Features & Use Cases - Full X API v2 coverage: Shortcut commands for posting, replying, quoting, deleting, searching, timelines, mentions, likes, reposts, bookmarks, follows, blocks, mutes, and DMs, plus raw curl-style access to any v2 endpoint. - Media uploads: Upload images and videos, poll processing status, and attach media IDs to posts. - Multi-app and multi-account support: Isolated credentials per app with OAuth 2.0 PKCE auto-refresh, switchable via --app or xurl auth default. - Use Case: Ask the agent to search X for recent posts about a topic, then like and reply to the most relevant results — all actions verified through the JSON output of each xurl command. ## Quick Start Ask the agent to run xurl auth status to verify credentials, then have it search X for a topic and reply to one of the returned posts.

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 the command xurl post "your message" after completing one-time OAuth 2.0 setup. You can attach media by uploading first with xurl media upload and passing the returned media ID via --media-id.

How to search X posts and get raw post JSON?▼

Run xurl search "QUERY" -n 10 to query the X index as your authenticated account. It returns raw post objects with IDs, authors, and full text that can be immediately engaged with via reply, like, or repost commands.

Does xurl support multiple X accounts or apps?▼

Yes, xurl supports multiple registered apps with isolated credentials and tokens. Switch between them using xurl auth default APP_NAME or per-request with the --app flag, and select accounts with -u or --username.

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

This happens when the OAuth token is saved to the built-in default app profile, which has no client ID or secret. Fix it by re-running xurl auth oauth2 --app my-app and then xurl auth default my-app.

Can xurl upload videos to X?▼

Yes, xurl media upload handles videos with server-side processing. Check processing status with xurl media status MEDIA_ID or use --wait to poll, then attach the media ID to your post.

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
enunoenuno

social-monitor

Monitor social media mentions and sentiment using XAI and Reddit APIs.

Community
Intermediate
Atrium-HermesAtrium-Hermes

[REPLACE: SKILL_NAME]

Aggregate daily social mentions and score sentiment across Twitter/X and Reddit.

Community
Advanced
karis-aikaris-ai
19

page-seo

Analyze on-page SEO performance and generate optimization plans.

Official
Intermediate