X API Skill
https://github.com/jarrodwatts/x-api-skill- Category
- AI Agents
- Rank
- No. 1795Tools index
Previous survey · No. 1802 ·
- Pricing
- Open Source
- Type
- AGENT
- Builder
- jarrodwatts
- GitHub
- 6 stars
- Date
About
Let your AI agent use X (Twitter) on your behalf — post, reply, search, DMs, bookmarks, and more.
What it does
This is a context package that teaches an AI agent to translate plain-language X tasks into concrete API requests. Its guidance covers endpoint choice, authentication modes, scopes, request fields, pagination, rate-limit responses, and error handling. Write operations should be explained and confirmed before execution.
Why it's ranked here
The strongest case is its operational depth. The repository pairs broad endpoint references with practical request examples, credential guidance, safety rules, and documentation-generation utilities. The limitation is equally clear: this is an agent playbook, not a standalone client, so successful execution still depends on credentials, network access, command-line tools, and the host agent following the guidance.
What's good
It consistently separates public reads from user-context writes and recommends least-privileged authentication. Tokens stay in environment variables instead of command text. Search guidance includes result caps and pagination stop conditions. Write guidance requires explicit side-effect confirmation, while bulk actions require limits and compliance checks. Topic references cover posts, users, lists, media, Spaces, trends, news, usage, search, and migration.
Tradeoffs
The package does not provide a complete API client or abstract away account setup. Users must create an X app, obtain suitable tokens, configure scopes, and retain responsibility for policy compliance. Some access depends on the user’s X plan. Media posting also needs a runtime capable of reading local files and uploading bytes. Documentation extraction relies on heuristics around fenced OpenAPI content.
How to use it well
Use it when an AI coding agent needs repeatable, guarded X API work and you already have, or can configure, developer credentials. It fits interactive research, account maintenance, posting, and narrowly capped automations where reviewing exact requests matters. Keep humans involved for writes and outreach. It does not replace OAuth provisioning, an application runtime, media file handling, or policy judgment for large-scale automation.
Technical notes+
SKILL.md defines the agent contract, credential environment variables, safety rules, expected request output, and links into the reference set. agents/openai.yaml supplies the agent-facing display metadata and default prompt. scripts/x_openapi_curl.py is a dependency-free Python CLI that reads a local or remote Markdown page, heuristically parses the first four-backtick OpenAPI YAML fence, extracts method, path, server, and security data, then prints a curl skeleton. scripts/build_x_docs_catalog.py fetches the X documentation index concurrently, extracts endpoint metadata, generates grouped inventories, and updates curated references. references/posts.md, references/users.md, references/search.md, and related topic files combine examples with endpoint and authentication inventories.
Observed
- License
- MIT
- Install surface
- Agent skill installed with npx skills add jarrodwatts/x-api-skill
- Interfaces
- Agent context guidance, curl-based X API requests, and Python command-line utilities
- Implementation
- Markdown reference material with dependency-free Python 3 scripts
- Runtime requirements
- Requires curl, Python 3, and network access to docs.x.com and api.x.com
- API target
- Official X API v2
- Credential surface
- Environment variables for an app-only bearer token and an OAuth user access token
Read from README.md, scripts/x_openapi_curl.py, scripts/build_x_docs_catalog.py, SKILL.md, agents/openai.yaml, references/news.md, references/lists.md, references/media.md, references/posts.md, references/usage.md, references/users.md, references/search.md, references/spaces.md, references/trends.md, references/migrate.md.
What it can do
Post tweets
Tweet content → Published tweet on X
Reply to tweets
Tweet to reply to and reply content → Published reply on X
Search X content
Search query → Matching tweets and user profiles
Send direct messages
Recipient and message content → Sent DM on X
Bookmark tweets
Tweet to bookmark → Bookmarked tweet in user's collection
Retrieve bookmarked tweets
User account access → List of bookmarked tweets
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.