| name | mux-docs |
| description | Use for any question about Mux APIs, SDKs, the mux CLI, webhooks, assets, uploads, playback, live streaming, Mux Data, or Mux Robots. Finds the current Mux documentation — Mux publishes every docs page as LLM-ready markdown indexed at mux.com/llms.txt — so answers come from today's published docs instead of web search or model memory. |
Mux docs discovery
Mux publishes its entire documentation as agent-ready markdown, auto-generated from the same source as the real docs site. For any Mux question, fetch the relevant page and answer from it — never answer Mux API questions from memory, because API shapes and guidance change.
Workflow
- Route. Pick the most specific starting point:
- A known page URL (see collection indexes below to find one).
- A collection index for the topic area (small, fast to scan).
- An API reference bundle or spec (below) for exact request/response shapes.
- The Mux Robots guides (below) for AI video workflows — summaries, moderation, captions, chapters, and more.
- https://www.mux.com/llms.txt — the master index of every docs page — when you don't know where the topic lives.
- Fetch the page's markdown. Every docs page has a markdown version: append
.md to its URL (e.g. https://www.mux.com/docs/guides/start-live-streaming.md).
- Answer from the fetched content and cite the page URL.
Collection indexes
https://www.mux.com/llms-full.txt is the entire documentation in one file — very large; prefer per-page fetches.
Mux Robots (AI video workflows)
Robots — Mux's AI-powered video workflows — don't have their own collection index; their guides are part of the video collection and the master llms.txt index. Start here:
Task-specific guides follow the pattern https://www.mux.com/docs/guides/robots-<task>.md, where <task> is one of: summarize, moderate, generate-chapters, ask-questions, find-key-moments, find-scenes, find-best-thumbnails, translate-captions, translate-audio, generate-premium-captions, edit-captions, generate-engagement-insights.
API references and specs
For exact endpoint, parameter, and webhook shapes, prefer these over prose guides:
All of these resources are also discoverable from the docs site itself: every docs page links to "Docs for LLMs" (https://www.mux.com/docs/core/llms-txt), the canonical page describing Mux's llms.txt files and machine-readable bundles. If this skill's URL lists ever drift from reality, that page is the source of truth.
Self-healing
If a docs URL 404s, the docs have likely been reorganized. Do not give up after one 404: fetch https://www.mux.com/llms.txt, search it for the topic, and use the current URL.
Staying in sync
- This skill is distributed from the
muxinc/skills repository. If the Mux CLI is installed, refresh installed skills with mux skills update; otherwise pull the latest from https://github.com/muxinc/skills.
- If the
mux CLI is installed, mux docs path --json prints the local paths to its embedded agent skill and bundled docs — useful offline. Check mux docs --help for what the installed version offers; when the network is available, prefer the live fetch workflow above so answers reflect today's published docs.
Guardrails
- Cite the docs page URL you answered from.
- If the network is unavailable, say you could not verify against current docs — never guess API request/response shapes from memory.
