In short:
ak-mintlifyedits and checks Mintlify docs sites: adding pages, changing the look, building an API section, making docs AI-friendly, or putting docs online. It reads the existing site first, then runs the check commands the project already has. It does not install the CLI globally, does not scaffold a new site just to edit one page, and does not report a deploy as done without proof.
Disclosure: I maintain AgentKit and have an affiliate relationship with it: the AgentKit link in this post is an affiliate link; buying through it gets you 30% off.
Summary
Use it when you have a docs site built on Mintlify and need to add pages, change the look, build an API section, or put the docs online. You do not need it if you have no Mintlify site and do not plan to create one.
flowchart LR
A["Work on a Mintlify site"] --> B["ak-mintlify"]
B --> C["Edit docs.json, MDX, navigation, API"]
C --> D["Installed check commands pass"]
B --> E["Deploy to the target you name"]
E --> F["Proof the site is live"]It sticks to 4 principles:
| Principle | Question | Example |
|---|---|---|
| Read the site first | How is your site built? | Opens the docs folder, package.json, lockfile, docs.json and navigation before picking a command |
| Six work areas | Which area does your task belong to? | Config, content, navigation, OpenAPI, deploy, AI (llms.txt, open-in-AI menu, MCP) |
| Match the installed version | Is this config example still right for my Mintlify version? | Checks the project's CLI help and the docs for that version instead of pasting an old example |
| Check after editing | What evidence shows the edit broke nothing? | mint validate passes, mint broken-links finds no broken links, render reviewed if the layout changed |
If the project already has a preview running, it reuses it. For any process it starts itself, it records the command, PID and port, and stops it when the work is done.
Sample prompt for adding a new page:
/ak-mintlify Add a "Webhooks" page to the <product name> docs in <docs folder>.
Content: how to register a webhook, a sample payload, how to verify the signature.
Constraints: put it in the existing "Guides" group in navigation, do not change the theme.
Done when: the project's validate and broken-links commands pass.This skill has no flags. After the command name you write the task, optionally followed by a path in the project, or you simply describe the task in words.
Below is the detailed version: the run flow, 5 situations with prompts, how to write the input, the change history by ak release, and common pitfalls. The detailed version and the interactive page are for subscribers. Your agent can also search them through the portal's MCP.
Opens when your account has subscriber access
This guide is for subscribers
Once your account has access, the full piece, the interactive visual and the agent call all open.
- Sign in or create a modernEngineer accountReading access belongs to your account email.
- Choose a plan on the pricing page1, 3 or 12 months, paid by VietQR bank transfer. Access opens about a minute after the money arrives.
- Or redeem a Facebook subscriber codePeople supporting the page on Facebook get an activation code by message each month.
Already a subscriber? Sign in to read.
Use this piece in your agent
Get an API keyCopy the text below and paste it into Claude Code, Codex or whichever agent you use. The agent reads the piece and checks it against the repo you have open.
Read "ak-mintlify: edit and check Mintlify docs sites" on modernEngineer and apply it to this repo.
1. Call the content_get tool of the modernengineer MCP server with locale "en", slug "ak-mintlify". If the modernengineer MCP server is not connected, stop and walk me through connecting it from https://modernengineer.dev/en/mcp.
2. Summarize the main steps of the piece and point out which apply to this repo.
3. Propose concrete changes and ask me before editing any file.Connect MCP in Claude Code (once)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Reading the full piece over MCP needs an API key from a subscriber account or one that bought this guide. Without access, the agent only gets the opening.
- Version
- v1.0.0
- Updated
- 22/10/2026
- Licence
- All rights reserved
- Slug
- ak-mintlify
