A collection of Agent Skills for interacting with Read the Docs APIs and services.
Warning: Most of the content in this repository is AI-generated and may contain mistakes. Review carefully before use.
Agent Skills are modular packages that extend AI agent capabilities. Each skill is a folder containing a SKILL.md file with instructions, plus optional supporting files like scripts and templates.
Skills are model-invoked — agents autonomously decide when to use them based on your request and the skill's description.
Learn more at agentskills.io
Query the Read the Docs Search API to find documentation across projects and repositories.
- Location:
skills/readthedocs-search-api/ - Use when: Searching documentation, finding related docs, finding API documentation, or gathering information about projects on Read the Docs
- RTD_HOST:
- Community:
https://app.readthedocs.org - Business:
https://app.readthedocs.com
- Community:
- Search across millions of pages of documentation
- No authentication required (public API)
- Paginated results
- Project and version information
- HTML highlights of matched text
- Section-level search results
See skills/readthedocs-search-api/SKILL.md for detailed instructions.
Manage Read the Docs projects via the RTD API: create projects, trigger builds, sync versions, and check build status.
- Location:
skills/readthedocs-project-manager/ - Use when: Creating projects, listing repos, triggering builds, syncing versions, or checking build status
See skills/readthedocs-project-manager/SKILL.md for detailed instructions.
Manage Read the Docs redirects via the RTD API: list, create, update, and delete custom redirect rules for a project.
- Location:
skills/readthedocs-redirects-manager/ - Use when: Listing, creating, updating, or deleting custom redirects
See skills/readthedocs-redirects-manager/SKILL.md for detailed instructions.
Triage Read the Docs build failures using build logs and config context.
- Location:
skills/readthedocs-build-failure-triage/ - Use when: A build fails, logs need analysis, or you need fix recommendations
See skills/readthedocs-build-failure-triage/SKILL.md for detailed instructions.
Create or update Read the Docs .readthedocs.yaml v2 configuration files for Sphinx or MkDocs builds.
- Location:
skills/readthedocs-write-config/ - Use when: You need a new
.readthedocs.yamlfile or changes to build images, tools, dependency installs, formats, build jobs, conda, submodules, or search settings
See skills/readthedocs-write-config/SKILL.md for detailed instructions.
Clone this repository and use the skill directories directly:
git clone https://github.com/readthedocs/skills.gitOr add it as a submodule and reference the skill directories you need:
git submodule add https://github.com/readthedocs/skills.gitSkills are automatically discovered by Claude and other compatible agents. Simply ask a question that matches a skill's description, and the agent will use it autonomously.
Example:
Can you find documentation on the Read the Docs YAML file
The Read the Docs Search API skill will activate and search the API for relevant documentation.
.
├── README.md
└── skills/
├── readthedocs-search-api/
│ └── SKILL.md
└── readthedocs-write-config/
└── SKILL.md
To add a new skill:
- Create a directory under
skills/with a descriptive name - Add a
SKILL.mdfile with YAML frontmatter and instructions - (Optional) Add supporting files like scripts or references
- Test the skill with your agent
- Submit a pull request
See agentskills.io/specification for the complete SKILL.md format specification.
These skills are available under the MIT License. See LICENSE for details.