mintlify: a Claude Code skill by Mintlify
Official
For teams that want a docs site built, edited or migrated on Mintlify. Skip it if your docs live on another platform you plan to keep.
The skill's text changed on Nov 11, 2026, after we last read it. Our description may be behind.
- Score
- 76of 100
- Rank
- #114of 239
- Installs
- 19.8Kon skills.sh
- Security
- Mixed 5 scanners
- Updated
- 2026
- Context
- ~149tokens always
Install
npx skills add https://github.com/mintlify/docs --skill mintlify
Run it in your terminal. View the source
Using the Claude app rather than Claude Code? You can add a skill there too. How to add it in the app
What does mintlify do?
mintlify is a skill from Mintlify that covers starting, writing and publishing docs sites on its platform. For a new site Claude checks Node.js, installs or updates the mint CLI, checks your account with mint status, previews with mint dev, runs mint validate and mint broken-links, then pushes to deploy. Without an account it deploys an unclaimed site and claims it with your email. It also covers migrating from Docusaurus, GitBook, ReadMe or Fern, docs.json navigation, MDX components and frontmatter, and two MCP servers: one to search Mintlify docs and one to edit, comment on and publish pages on a branch. Publishing waits for your request.
When should you use mintlify?
Use it when
- You want a hosted docs site from a README or docs folder
- You are moving docs off GitBook or Docusaurus
- You need API reference pages from an OpenAPI file
Skip it when
- Your docs stay on another platform
- You only need a plain README
What it needs and what it can touch
You need
- Node.js 20.17 or newer and the mint CLI
- A Mintlify account (or one claimed after deploy)
- A GitHub repository for automatic deploys
What it can do
- Runs shell commands (mint, git, npm)
- Installs the mint CLI globally
- Reads and edits docs files in your project
- Commits and pushes to your docs repository
- Sends content to an outside service (Mintlify)
From reading its instructions, not from running it.
Why it scores 76
Strongest on upkeep (100 of 100), weakest on adoption (40).
Is mintlify safe to install?
At least one scanner raised a medium warning. Read the results below. Scanners often miss what other scanners catch, and a skill can change after a scan. Read its source before you install it.
| Scanner | Result | Date |
|---|---|---|
| Gen Agent Trust Hub | Passed | Nov 11, 2026 |
| Socket | Passed | Nov 8, 2026 |
| Snyk | Medium risk | Nov 11, 2026 |
| Runlayer | Passed | Feb 25, 2026 |
| ZeroLeaks | Passed | Apr 15, 2026 |
Details
- Installs
- 19,760
- Repository stars
- 466
- Last repository change
- Tokens always loaded
- about 149
- Tokens when used
- about 6,455
- License
- MIT
- Data confidence
- High
Did it do the job for you?
Alternatives to mintlify
All skills for this job-
Get spec-driven-implementationspec-driven-implementation
For teams building large features who want PRODUCT.md and TECH.md specs checked in before and during coding.
mintlify