Skip to main content

View skill.md

The live skill.md file for the X API documentation.
The skill.md file follows the agentskills.io specification and describes what AI agents can do with the X API. While llms.txt is a directory of pages, skill.md is a capability summary — it lists specific actions, required inputs, and constraints so agents can use the API more reliably.

​
What’s included

  • Capabilities — what agents can accomplish (search posts, create posts, manage users, etc.)
  • Skills — specific actions organized by category with required parameters
  • Workflows — step-by-step procedures for common tasks
  • Context — background on authentication, rate limits, and architecture
# Fetch the skill file
curl https://docs.x.com/skill.md

​
Discovery endpoints

Agents can discover skill files programmatically via the well-known endpoints: 
# Discovery endpoint (agent-skills 0.2.0 spec)
curl https://docs.x.com/.well-known/agent-skills/index.json

# Original discovery format
curl https://docs.x.com/.well-known/skills/index.json
You can add X API capabilities to any agent that supports the skills CLI: 
npx skills add https://docs.x.com