Agent skill

Mintlify

by lilinji in lilinji/ai-infra-odyssey

Comprehensive reference for building Mintlify documentation sites.

No licenceAuto-check passedFrontend & Design

Install Mintlify

skills CLI
$ npx skills add lilinji/ai-infra-odyssey --skill mintlify -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lilinji/ai-infra-odyssey mintlify --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lilinji/ai-infra-odyssey.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/mintlify .claude/skills/mintlify && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mintlify
GitHub stars
130
Token cost
~2.9k tokens
SKILL.md length
1,202 words
Files
7
Skills in repo
2
Repo updated
First seen
Licence
None found

At a glance

Comprehensive reference for building Mintlify documentation sites.

  • Configuring docs.json
  • SKILL.md covers Reference index, MCP servers, Before you start and File format, plus 5 more sections
  • Calls npm
  • Adding components

What it does

Mintlify is an agent skill from lilinji/ai-infra-odyssey. Comprehensive reference for building Mintlify documentation sites. Use when creating pages, configuring docs.json, adding components, setting up navigation, or working with API references. Routes to detailed reference files for all components and configuration options.

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files (for example `reference/api-docs.md`, `reference/cli.md` and `reference/components.md`).

It sits in Frontend & Design, covering Static sites and blogs. The repository describes itself as: AI Infra 大话西游之水滴石穿 - 专栏全景硬核技术实战.

When your agent uses it

  • Configuring docs.json
  • Adding components
  • Setting up navigation
  • Working with API references

Example prompts

  • “/mintlify”

Requirements

  • Python 3
  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit 38e26eb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mintlify loads about 2.9k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 1,202 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,202 words (~2,917 tokens).

“Reference for working on Mintlify projects. This file covers essentials that apply to every task. For detailed reference on specific topics, read the files listed in the reference index below.”

— opening of SKILL.md by lilinji
name
mintlify

Read the full SKILL.md on GitHub

Files

SKILL.md and 6 other files in .claude/skills/mintlify of lilinji/ai-infra-odyssey.

  • SKILL.md
  • reference/api-docs.md
  • reference/cli.md
  • reference/components.md
  • reference/configuration.md
  • reference/navigation.md
  • reference/product-context.md

Open the folder on GitHubat commit 38e26eb

Compare with similar skills

Mintlify next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mintlify compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mintlify this skilllilinji/ai-infra-odyssey130—~2.9kAutomated safety check: PassNone
Tabler Astro Dev Servertabler/tabler42k—~1.2kAutomated safety check: PassMIT
Create Docsvictorgarciaesgi/nuxt-typed-router4132 repos~2.8kAutomated safety check: PassMIT
Tabler Astro Component Scriptstabler/tabler42k—~2.1kAutomated safety check: PassMIT
Paperclip Pagepaperclipai/paperclip99k—~1kAutomated safety check: PassMIT
Kill AI Slopyetone/kill-ai-slop1.3k—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Starts the right Tabler dev server, keeps it from clashing with builds and verifies changes in the browser before a page or component is handed back.

    42k GitHub stars~1.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Create Docs

    victorgarciaesgi/nuxt-typed-router

    Create complete documentation sites for projects. An agent skill from victorgarciaesgi/nuxt-typed-router.

    413 GitHub starsUsed in 2 repos~2.8k tokens
    Frontend & DesignAuto-check passed
  • Rules for adding or fixing client-side scripts in Tabler's Astro components so the copied preview HTML stays readable, self-contained and runs in the right order.

    42k GitHub stars~2.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Paperclip Page

    paperclipai/paperclip

    Publish static HTML pages and asset folders to the Paperclip S3/CloudFront page host.

    99k GitHub stars~1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Kill AI Slop

    yetone/kill-ai-slop

    Find and remove AI slop — the generic, machine-default visual and copy tics of vibe-coded products — from a web project.

    1.3k GitHub stars~1.4k tokensUpdated 24 days ago
    Frontend & DesignAuto-check passed
  • Official

    Audit a documentation site for agent-friendliness: discovery, markdown delivery, crawlability, semantic structure, machine-readable surfaces, and content legibility.

    4.7k GitHub stars~1.8k tokensUpdated today
    Frontend & DesignAuto-check passed

More from lilinji/ai-infra-odyssey

  • Mintlify Claude Docs

    lilinji/ai-infra-odyssey

    Build, write, review, migrate, and maintain Mintlify documentation in a restrained Claude Docs-inspired style.

    130 GitHub stars~8.2k tokensUpdated 11 days ago
    Auto-check passed

Questions about Mintlify

What does Mintlify do?

Comprehensive reference for building Mintlify documentation sites. Mintlify is an agent skill from lilinji/ai-infra-odyssey. Comprehensive reference for building Mintlify documentation sites.

When should I use Mintlify?

Mintlify fits situations like: configuring docs.json; adding components; setting up navigation; working with API references.

How do I install Mintlify in Claude Code?

Run `npx skills add lilinji/ai-infra-odyssey --skill mintlify -a claude-code`. Or copy the skill folder (.claude/skills/mintlify in lilinji/ai-infra-odyssey) into .claude/skills/mintlify in your project. Claude Code loads it when a task matches its description.

How do I install Mintlify in Codex?

Run `npx skills add lilinji/ai-infra-odyssey --skill mintlify -a codex`. Or copy the skill folder (.claude/skills/mintlify in lilinji/ai-infra-odyssey) into .agents/skills/mintlify in your project. Codex loads it when a task matches its description.

Can I use Mintlify in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lilinji/ai-infra-odyssey --skill mintlify -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mintlify, .gemini/skills/mintlify, .github/skills/mintlify and .opencode/skills/mintlify in your project.

What does Mintlify need to run?

Going by SKILL.md and its folder, Mintlify needs the command-line tools its instructions call (npm). Our summary lists: Python 3; Node.js.

Does Mintlify access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Mintlify safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mintlify use?

No licence was found for Mintlify or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Mintlify use?

About 2.9k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mintlify?

Skills that share tags, products or a category with Mintlify: Tabler Astro Dev Server (tabler/tabler, 42k stars), Create Docs (victorgarciaesgi/nuxt-typed-router, 413 stars), Tabler Astro Component Scripts (tabler/tabler, 42k stars) and Paperclip Page (paperclipai/paperclip, 99k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mintlify?

lilinji (a GitHub user) maintains it in lilinji/ai-infra-odyssey, which has 130 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on September 28, 2026.

Source: lilinji/ai-infra-odyssey on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.