# Mintlify agent skills for Claude Code, Cursor and RevampKey

> Ready-made Mintlify playbooks for AI agents: restructure your docs navigation with AI, update a Mintlify docs page with AI, review and close out a docs editing session. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Using the Mintlify admin connector safely](https://revampkey.com/marketplace/mintlify/skills/essentials.md): A guide to the Mintlify admin connector: confirm the project and deploy branch, choose between read-only and full access, and approve every content or settings change before it runs.
- [Restructure your docs navigation with AI](https://revampkey.com/marketplace/mintlify/skills/docs-navigation-restructure.md): Plans and applies sidebar and page-hierarchy changes on a branch, checks for orphaned pages and broken links, and asks before every move or delete.
- [Update a Mintlify docs page with AI](https://revampkey.com/marketplace/mintlify/skills/docs-page-update.md): Edits one existing docs page on its branch, reviews the diff, and asks before publishing or opening a pull request.
- [Review and close out a docs editing session](https://revampkey.com/marketplace/mintlify/skills/docs-session-review-and-cleanup.md): Checks what is still pending in a Mintlify editing session, reads the real changes, and then publishes the finished work or discards the rest, asking before each action. Nothing ships or is dropped without your confirmation.

## Install

- RevampKey: connect Mintlify at https://revampkey.com/marketplace/mintlify; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
for s in essentials docs-navigation-restructure docs-page-update docs-session-review-and-cleanup; do
  curl -fsSL --create-dirs -o .agents/skills/mintlify-$s/SKILL.md https://revampkey.com/marketplace/mintlify/skills/$s/SKILL.md
done
```

### What is a Mintlify agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Mintlify skill describes one job, which Mintlify tools to use in which order, what to check first and when to stop and ask you.

### Do the Mintlify skills change anything on their own?

2 of the 4 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Mintlify.

### Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Mintlify; elsewhere you copy the folders into your project or skills directory.

### Do I need the Mintlify MCP server too?

Yes. The skills tell the agent how to do the work; the Mintlify MCP server gives it the tools to do it. The Mintlify MCP setup guide covers every client.

MCP setup guide: https://revampkey.com/marketplace/mintlify.md