AI coding agents build better integrations when they read the right docs first. Mediux publishes everything an agent needs as plain text, free to fetch:
| File | What it is |
|---|---|
SKILL.md | The Mediux Agent Skill: the rules every integration follows |
llms.txt | An index of every docs page, linked as Markdown |
llms-full.txt | Every guide and concept page in one file |
openapi.json | The OpenAPI 3.1 document, for types and generated clients |
<page>.md | Any docs page as Markdown: add .md to its path, as in /api/errors.md |
Each page also has Copy as Markdown and View as Markdown under its title.
Add the skill
Section titled “Add the skill”The skill tells your agent how to call the API, cache responses, build image URLs, handle errors and connect users, and what apps can’t do.
In Claude Code, save it as a project skill:
mkdir -p .claude/skills/mediuxcurl -o .claude/skills/mediux/SKILL.md https://docs.mediux.io/skills/mediux/SKILL.mdOther agents that support Agent Skills take the same file in their skills folder. Download it again now and then to pick up changes.
Or add it to AGENTS.md
Section titled “Or add it to AGENTS.md”For any agent that reads an AGENTS.md (or a similar rules file), paste this in:
## Mediux
This project uses the Mediux API. Before writing Mediux code, readhttps://docs.mediux.io/skills/mediux/SKILL.md and follow its rules. Look upendpoints in https://docs.mediux.io/llms.txt and https://docs.mediux.io/openapi.json;don't guess paths or field names.Starter prompt
Section titled “Starter prompt”Build <what you want> using the Mediux API. First readhttps://docs.mediux.io/skills/mediux/SKILL.md and https://docs.mediux.io/llms.txt,then the pages you need. Generate types from https://docs.mediux.io/openapi.json.Follow the skill's rules on caching, image URLs, errors and OAuth, and finish withits "Before you ship" checklist.