Agent skill · software engineering · steipete
xurl
xurl CLI for authenticated X posts, replies, reads/search, DMs, media upload, followers, auth status, or raw v2 API calls.
Why this skill is useful
Adds specific commands and workflows for interacting with the X API that the AI wouldn't reliably generate on its own.
What it needs
Requires xurl installed locally. Requires x account access. About 1k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
xurl Use xurl for X API work. Shortcut commands return JSON; raw mode works for any v2 endpoint. Auth ~/.xurl holds tokens; check auth with xurl auth status instead of reading it. Pass secrets to auth commands through the prompt, not inline, so they stay out of shell history. --verbose prints auth headers into tool output. Common shortcuts POSTID can be a full https://x.com/<user>/status/<id> URL. Media Videos may need processing; poll media status. Auth/app management Per request: Raw API Use raw mode when shortcuts do not cover the endpoint. Keep payloads in temp files for complex JSON. Output and errors JSON stdout on success. Non-zero exit on API/auth/network errors. 401/403: auth, scope, or app mismatch; check xurl auth status. 429: rate limited; back off. Media upload failures: check file type/size and media processing status.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/xurl--aacd1c