skills.rest
perasyudha
perasyudhaCOMMUNITY
Explore all skills by this author →
Website𝕏@Nyxora_AIGitHub

xurl

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

5|2|Updated May 26, 2026
Search Tags:#automation#social media#cli#twitter#oauth2#post#x api
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill xurl-perasyudha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: xurl
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/social-media/xurl
Command: npx skills add https://github.com/perasyudha/Nyxora --skill xurl-perasyudha

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, read timelines, send DMs, and call any X API v2 endpoint with simple commands that return structured JSON. ## Core Features & Use Cases - Full posting workflow: Post, reply, quote, delete, and attach images or video with media upload and processing-status checks. - 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 support. - Use Case: Ask the agent to search X for posts about a topic, review the JSON results, then like and reply to a selected post after confirming intent. ## Quick Start Ask the agent to verify xurl is authenticated with "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 the xurl CLI: run "xurl post \"Hello world!\"" after completing one-time OAuth setup. For media, run "xurl media upload photo.jpg" first, then pass the returned ID with "xurl post \"text\" --media-id MEDIA_ID".

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

Run "xurl search \"query\" -n 10" for search, "xurl timeline -n 20" for your home timeline, and "xurl mentions -n 10" for mentions. All commands return X API v2 JSON to stdout.

Does xurl support raw X API v2 endpoints and streaming?▼

Yes. Use curl-style syntax like "xurl /2/users/me" or "xurl -X POST /2/tweets -d '{...}'" for any v2 endpoint. Streaming endpoints such as /2/tweets/search/stream are auto-detected, or force streaming with -s.

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

The token was likely saved to the built-in default app, which has no client credentials. Re-run "xurl auth oauth2 --app my-app" and then "xurl auth default my-app", and verify with "xurl auth status" that the default app shows an oauth2 user.

Can an AI agent handle xurl credentials or read the ~/.xurl file?▼

No. The skill forbids agents from reading, printing, or sending ~/.xurl, and forbids inline-secret flags like --client-secret or --bearer-token. App registration and OAuth must be performed manually by the user outside the agent session.

Related Skills

Explore More Marketing & Sales Skills→
gqf2008gqf2008

xurl

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

Community
Advanced
claude-office-skillsclaude-office-skills
368

Twitter/X Automation

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

Official
Advanced
anysiteioanysiteio
19

anysite-trend-analysis

Detect emerging social media trends across Twitter/X, Reddit, YouTube, LinkedIn, and Instagram.

Official
Basic
NousResearchNousResearch
239.1k

xurl

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

Official
Intermediate