Mintlify agent skills for Claude Code, Cursor and RevampKey

4 ready-made playbooks that teach an AI agent how to do real Mintlify work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Mintlify

Connect Mintlify once and all 4 skills install themselves and stay up to date. Mac, Windows and Linux.

All 4 Mintlify skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereAsks before writing4 Mintlify tools

Using the Mintlify admin connector safely

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.

Use it when

Connecting Mintlify to an AI tool for the first time
Deciding whether an assistant should only read the docs or also edit them
Working out whether a docs change goes live now or through a pull request

Tools it uses

search
read
list_nodes
update_config

Example

Connect my Mintlify docs to Claude so it can help me edit pages, but make sure it can't publish anything without asking me first.

I'll set up a full admin connection scoped to your 'acme-docs' project, since that's the one you named. Edits to the deploy branch stay unpublished until you publish them. Before any edit, publish, or settings change, I'll list the exact action and wait for your explicit yes. For read-only questions, I can use the knowledge-only connection instead.

Use in RevampKeyRead the full skill →

Read-only4 Mintlify tools

Restructure your docs navigation with AI

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.

Use it when

Reordering the sidebar so related pages sit together
Splitting one large section into two smaller groups
Removing dead navigation entries and stranded pages

Tools it uses

checkout
list_nodes
read
diff

Example

Restructure the API reference section: merge the two single-page groups into their parent and move the auth pages under it.

I mapped the current tree on branch docs-restructure and found 3 single-child groups. The plan moves 6 pages, creates 1 group and deletes 2 empty groups, with 4 internal links to update. I'll apply the moves once you confirm the plan, and ask again before deleting anything.

Use in RevampKeyRead the full skill →

Asks before writing7 Mintlify tools

Update a Mintlify docs page with AI

Edits one existing docs page on its branch, reviews the diff, and asks before publishing or opening a pull request.

Use it when

Fix a wrong value or sentence on a single docs page
Rewrite a section while keeping the rest of the page intact
Check what changed before the update goes live

Tools it uses

search
list_nodes
checkout
read
edit_page
write_page
diff

Example

On the quickstart page, change the install command to the new package name and check the diff before publishing.

I changed the install command on the quickstart page on the docs branch and updated one line. The diff shows 1 line changed, 1 removed, with nothing else touched. Publishing will send this as unpublished changes to the live site. Say yes and I will publish, or I can open a pull request instead.

Use in RevampKeyRead the full skill →

Read-only4 Mintlify tools

Review and close out a docs editing session

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.

Use it when

You want to know what edits are still unpublished before you wrap up.
You are done editing and want to publish the good work and drop the rest.
You were editing docs last week and need to find out what is still pending.

Tools it uses

get_session_state
diff
discard_session
save

Example

What's still pending on the docs branch from today's session? Publish what's finished and tell me what's left.

Pending on branch docs-q3 across 6 pages, including 1 structural change (the API guide moved under Reference). Four pages are finished and ready to publish. Two are unfinished: the auth page has a TODO placeholder and the webhooks page has an empty section. I'll publish the four finished pages once you confirm, and leave the two unfinished ones parked on the branch.

Use in RevampKeyRead the full skill →

Get all 4 without copying a file

RevampKey adds the skills when you connect Mintlify, updates them for you and removes them when you disconnect.

Download RevampKey

How Mintlify skills work

Connect Mintlify
The Mintlify MCP server gives the agent its tools.
Ask in plain words
“Restructure the API reference section: merge the two single-page groups into their parent and move the auth pages under it.” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Mintlify skills

In RevampKey the skills install themselves when you connect Mintlify. In other tools each skill is one folder with a SKILL.md file, and you also need the Mintlify MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Mintlify. All 4 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Restructure the API reference section: merge the two single-page groups into their parent and move the auth pages under it.”
Download RevampKeyConnect Mintlify · 1 click
Get RevampKey to connect Mintlify
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Mintlify is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials docs-navigation-restructure docs-page-update docs-session-review-and-cleanup; do curl -fsSL --create-dirs -o .claude/skills/mintlify-$s/SKILL.md https://revampkey.com/marketplace/mintlify/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Mintlify MCP server in Claude Code.

Run this in your project folder to add all 4 skills:

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

Ask in plain language, for example “Restructure the API reference section: merge the two single-page groups into their parent and move the auth pages under it.”

Into the shared .agents/skills folder

Connect the Mintlify MCP server in Cursor.

Run this in your project folder to add all 4 skills:

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

Ask in plain language, for example “Restructure the API reference section: merge the two single-page groups into their parent and move the auth pages under it.”

Into the shared .agents/skills folder

Connect the Mintlify MCP server in Codex.

Run this in your project folder to add all 4 skills:

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

Ask in plain language, for example “Restructure the API reference section: merge the two single-page groups into their parent and move the auth pages under it.”

Into the shared .agents/skills folder

Connect the Mintlify MCP server in VS Code.

Run this in your project folder to add all 4 skills:

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

Ask in plain language, for example “Restructure the API reference section: merge the two single-page groups into their parent and move the auth pages under it.”

RevampKey or copy the files?

In RevampKey

One click when you connect Mintlify
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Mintlify MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Mintlify skills FAQ

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.

Mintlify MCP server setup · This page as Markdown

Put Mintlify’s best workflows in your agent

Download RevampKey, connect Mintlify and ask your first question in about a minute.

Download RevampKey Connect Mintlify · 1 click

All 4 Mintlify skills

Using the Mintlify admin connector safely

Use it when

Tools it uses

Restructure your docs navigation with AI

Use it when

Tools it uses

Update a Mintlify docs page with AI

Use it when

Tools it uses

Review and close out a docs editing session

Use it when

Tools it uses

Get all 4 without copying a file

How Mintlify skills work

How to install Mintlify skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Mintlify skills FAQ

Put Mintlify’s best workflows in your agent

Skills for related tools