Skip to content

Add an agent skill for using the CLI (skills/ directory) #54

Open

Description

@robertn702

Summary

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions