You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Add an agent skill for using the CLI (skills/ directory) #54
Please ship a first-party agent skill (e.g. skills/x-cli/SKILL.md) teaching coding agents how to use the x CLI effectively.
The CLI has a rich, discoverable command set (search, get, home, mentions, replies, quotes, counts, crawl, db/query, mcp, ...) with important tiering rules (public syndication vs. session-backed commands like search, home, bookmarks, followers). An agent that hasn't read the docs will re-derive this by trial and error; a skill short-circuits that.
Suggested contents
Install / build instructions and x doctor as the first health check
Command map: which questions each surface answers, and which require an authenticated session (x auth)
Core workflows: search a topic, read a thread (get + replies), pull a user's tweets, export from the local store (db query, export)
The read-only guarantee and rate-limit/behavior notes agents should respect
Pointer to x mcp for agents that prefer MCP over shelling out
Why
Skills (SKILL.md format) are the emerging standard for giving agents durable, on-demand guidance; discoverability beats README-scraping
Zero maintenance burden beyond the CLI itself: the skill just references the real commands
Keeps agent usage aligned with intended tiers, reducing misuse of session surfaces
Happy to open a PR drafting the SKILL.md if the approach sounds good.
Activity