Skip to content
Get packs

X API CLI (xurl)

Lets the agent run the xurl CLI to post, read, search and manage an X (Twitter) account via the X API.

Source Download skill
Repository
steipete/agent-scripts
Stars
7,433
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent how to use xurl, the official command-line tool for the X (formerly Twitter) API. Once installed, the agent can post, reply, quote, like, repost, bookmark, follow, read timelines and search, and send direct messages by running xurl commands on your machine. It also explains how to log in with OAuth and how to make raw requests to any X API endpoint.

Great for

  • Developers who automate or script actions on their own X account
  • Social media managers who want an agent to draft and publish posts or check mentions
  • Anyone already using the X developer platform who wants a quick CLI interface

Skip it if

  • People who have not set up an X developer app and cannot register credentials themselves, since setup requires manual steps outside the agent
  • Use on accounts you do not control or where automated posting could breach X's rules or harm your reputation, because the agent can publish, delete and message on your behalf

Try asking

  • “Post 'Launching our new release today!' to my X account”
  • “Show me the last 10 mentions I received and summarise them”
  • “Search X for posts from @XDevelopers and list the top 5”
  • “Follow the handle @example_user and bookmark post 1234567890”
Step-by-step guide: how to use X API CLI (xurl)Install, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    xurl.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip xurl.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip xurl.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run the auth steps yourself in a terminal, keeping secrets out of the agent chat, then let the agent use the saved login.
  • Ask the agent to confirm before any post, delete, or DM action, since these affect your live account.
  • Use xurl auth status and xurl whoami first to verify the setup works before asking for bulk actions.

What's inside

  • SKILL.md

Redistributed unmodified from steipete/agent-scripts under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.