X cli

Skill onfire7777/universal-ai-skills-library/skills/x-cli

Use when working with sferik/x-cli or the X API from the command line: authorizing X accounts, listing accounts, posting or replying, reading timelines, searching posts or users, streaming X events, managing follows, mutes, blocks, lists, direct messages, trends, places, or diagnosing the local `x` CLI install. Do not use for generic algebra variable "x" or unrelated command-line work.From its SKILL.md

Install

npx -y skills add onfire7777/universal-ai-skills-library --skill x-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.5 KB, 749 tokens by cl100k_base, as published. Nobody here has run it

x-cli Universal Adapter

Source

Upstream repository: https://github.com/sferik/x-cli
Local checkout: %USERPROFILE%\.x-cli\x-cli
Primary command: %USERPROFILE%\.local\bin\x.exe
Compatibility alias: %USERPROFILE%\.local\bin\x-cli.exe
Router delegator: skill-router xcli
X profile config: %USERPROFILE%\.xrc
Legacy read fallback: %USERPROFILE%\.trc
Universal stack source registry: %USERPROFILE%\.universal-ai-stack\config\source-integrations.json

Operating Model

Use this as a shared CLI source integration, not as copied skill bodies or a background service. The universal install uses:

one external source checkout for README-grounded reference,
one built Rust release on PATH as x,
a namespaced x-cli skill for routing and workflow instructions,
compact skill-router wrappers in each AI client.

No MCP bridge is required for normal X API work.

Authentication And Secrets

x-cli supports OAuth 1.0a and OAuth 2.0 and stores account/profile data in ~/.xrc. If ~/.xrc is missing, upstream can read legacy ~/.trc and migrate on write.

Never print, paste, store, or commit:

~/.xrc or ~/.trc,
consumer keys or secrets,
OAuth access tokens or refresh tokens,
direct messages, private account data, or private API output.

Start or inspect auth with:

x authorize
x accounts
x set active <account>

Use --profile <FILE> when the user explicitly wants an isolated profile file.

Common Workflows

Check the install:

x version
skill-router xcli status

Post or reply:

x update "post text"
x reply <post-id> "reply text"

Read or search:

x timeline
x mentions
x status <post-id>
x search all "query"
x search users "name or handle"

Account and social graph actions:

x accounts
x follow <screen-name>
x unfollow <screen-name>
x favorite <post-id>
x retweet <post-id>
x mute <screen-name>
x block <screen-name>

Lists, direct messages, trends, and places are available through the upstream command tree. Run command-specific help before using a less common subcommand:

x --help
x search --help
x stream --help
x list --help
x dm --help

Streaming Safety

Streaming commands keep HTTP connections open. For automation and AI-agent sessions, set X_STREAM_MAX_EVENTS unless the user explicitly wants an open-ended stream:

$env:X_STREAM_MAX_EVENTS = "25"
x stream all

Do not start persistent stream loops in the background without an explicit user request and a stop plan.

Router Selection Rules

Prefer this skill only when the task is specifically about x-cli, X API automation, X/Twitter account operations, timelines, posts, search, streams, direct messages, follows, blocks, mutes, lists, trends, places, or local diagnostics for the x command.

Reject this skill for generic "x" wording, algebra, unrelated CLI tooling, or generic social-media writing tasks that do not need the X API.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.