vigilio/dotfiles
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
dotfiles/.pi/agent/skills/xai-docs/SKILL.md
Vigilio Desto fb8470dbcf
initial: pi config — agents, prompts, skills, settings 
Captures:
- 12 agent definitions (vigilio + a-team + utility)
- 8 mission prompt configurations
- 3 skills (forgejo, senior-software-engineer, xai-docs)
- pi settings.json (default provider/model)
2026-04-05 11:57:42 +00:00

1.8 KiB
Raw Blame History

name description
xai-docs Query x.ai (Grok) documentation directly from any agent session. Use when working with x.ai APIs, Grok models, rate limits, function calling, or any x.ai-specific feature. Wraps the x.ai JSON-RPC docs endpoint via the xai-docs CLI tool.

x.ai Docs Tool

Query x.ai documentation without leaving your session. Available as the xai-docs CLI tool (on PATH).

Commands

# Search docs for a keyword or phrase
xai-docs search "rate limits"
xai-docs search "function calling" 10   # return up to 10 results (default: 5)

# Get a specific doc page by slug
xai-docs page "developers/quickstart"
xai-docs page "developers/models"
xai-docs page "developers/advanced-api-usage/batch-api"

# List all available page slugs
xai-docs list

Common Slugs

Topic Slug
Models + pricing developers/models
Quickstart developers/quickstart
Function calling developers/function-calling
Batch API developers/advanced-api-usage/batch-api
Async API developers/advanced-api-usage/async
Rate limits search for "rate limits" or check developers/models
Billing console/billing

When to Use

  • Before implementing x.ai API calls — check current model IDs, pricing, rate limits
  • When hitting errors — search for the error type or feature
  • When comparing Grok models — xai-docs page "developers/models" gives the full table
  • When working on x.ai provider config — check available endpoints and auth format

Notes

  • No auth required — public endpoint
  • Returns markdown content
  • The search command returns excerpts with page slugs — use page to get the full content
  • list returns all ~30+ page slugs if you want to browse
  • Endpoint: https://docs.x.ai/api/mcp (JSON-RPC, stateless)