Agent skill

Mintlify API

by macro-inc in macro-inc/macro

Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically.

MITAuto-check passedBackend & APIs

Install Mintlify API

skills CLI
$ npx skills add macro-inc/macro --skill mintlify-api -a claude-code

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

GitHub CLI
$ gh skill install macro-inc/macro mintlify-api --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/macro-inc/macro.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/docs/.agents/skills/mintlify-api .claude/skills/mintlify-api && 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-api
GitHub stars
4.6k
Used in
2 other repos
Token cost
~333 tokens
SKILL.md length
108 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically.

  • Query documentation site metadata programmatically
  • SKILL.md covers Authentication, Core capabilities and Resources
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Deployment

What it does

Mintlify API is an agent skill from macro-inc/macro. Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically.

Its SKILL.md is about 330 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Any HTTP client. Authentication via API key.

It sits in Backend & APIs, covering Deployment, Static sites and blogs and REST APIs. The repository describes itself as: Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory. The licence is MIT.

When your agent uses it

  • Query documentation site metadata programmatically
  • Tasks that involve Deployment
  • Tasks that involve Static sites and blogs

Example prompts

  • “/mintlify-api”

Requirements

  • Compatibility (from SKILL.md): Any HTTP client. Authentication via API key.

What it can do on your machine

Read from SKILL.md and the folder at commit 39f3c91. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • dashboard.mintlify.com
    • mintlify.com

    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.

  • Compatibility

    Any HTTP client. Authentication via API key.

    From compatibility in the SKILL.md frontmatter.

Context cost

Mintlify API loads about 333 tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 108 words of instructions outside code blocks.

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

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

The full file from macro-inc/macro at commit 39f3c91, republished under its MIT licence (© macro-inc). 108 words, ~333 tokens.

Download SKILL.mdSave it as .claude/skills/mintlify-api/SKILL.md (or your agent's skills folder).
name
mintlify-api
description
Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically.
compatibility
Any HTTP client. Authentication via API key.
license
MIT
metadata.author
mintlify
metadata.version
1.0

Mintlify API

Use the Mintlify API to manage documentation sites programmatically. This skill covers deployment management, build triggers, and site metadata queries.

Authentication

All API requests require an API key passed in the Authorization header:

Authorization: Bearer <your-api-key>

Generate API keys from the Mintlify dashboard under Settings > API Keys.

Core capabilities

Trigger deployments

Programmatically trigger a documentation rebuild when your codebase changes outside of Git push events.

Query site metadata

Retrieve information about your documentation site including deployment status, configured domains, and navigation structure.

Manage preview deployments

Create and manage preview deployments for pull requests and branches to review documentation changes before they go live.

Resources

© macro-inc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in apps/docs/.agents/skills/mintlify-api of macro-inc/macro.

Open the folder on GitHubat commit 39f3c91

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in macro-inc/macro, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Mintlify API 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 API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mintlify API this skillmacro-inc/macro4.6k2 repos~333Automated safety check: PassMIT
Frappe Ops Website DeployImpertio-Studio/Frappe_Claude_Skill_Package187—~2.5kAutomated safety check: PassMIT
Golem Add HTTP Endpoint Effectgolemcloud/golem1.5k—~3.3kAutomated safety check: PassCustom licence
Ship Coolifykovrichard/catalyst470—~1.9kAutomated safety check: NotesNone
Finding TriageHacktronAI/skills115—~2.9kAutomated safety check: NotesMIT
Cloudflare Pagessickn33/agentic-awesome-skills47k2 repos~2.4kAutomated safety check: PassMIT

Similar skills

  • Frappe Ops Website Deploy

    Impertio-Studio/Frappe_Claude_Skill_Package

    Deploy HTML/CSS websites to ERPNext/Frappe (v15/v16) as Web Pages via the REST API.

    187 GitHub stars~2.5k tokensUpdated 20 days ago
    Backend & APIsAuto-check passed
  • Exposing an Effect-based Golem agent over HTTP. An agent skill from golemcloud/golem.

    1.5k GitHub stars~3.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • Ship Coolify

    kovrichard/catalyst

    Verify a Coolify deploy end-to-end after a push — wait for GitHub CI, then the Coolify deployment, confirm the commit is live, and run a visual check.

    470 GitHub stars~1.9k tokensUpdated 8 days ago
    Backend & APIsAuto-check: notes
  • Finding Triage

    HacktronAI/skills

    Interactively validate and triage Hacktron findings against the actual source code and (optionally) a live deployment, separate true positives from false positives, adjust severity, then either…

    115 GitHub stars~2.9k tokensUpdated 4 mo ago
    Backend & APIsAuto-check: notes
  • Cloudflare Pages

    sickn33/agentic-awesome-skills

    Deploy static sites and full-stack apps on Cloudflare Pages with previews, functions, and custom domains.

    47k GitHub starsUsed in 2 repos~2.4k tokens
    DevOps & CloudAuto-check passed
  • Implementing Deception Based Detection With Canarytoken

    mukul975/Anthropic-Cybersecurity-Skills

    Deploys and monitors Canary Tokens via the Thinkst Canary REST API for deception-based breach detection, programmatically creating web bug, DNS, MS Word document, and AWS API key tokens and…

    34k GitHub stars~591 tokensUpdated 1 mo ago
    DevOps & CloudAuto-check passed

More from macro-inc/macro

All 19 skills in this repo
  • Add Tour

    macro-inc/macro

    Add or change an in-app feature tour (a view's guided flyover) in the web app.

    4.6k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Define Feature Flag

    macro-inc/macro

    Define a frontend feature flag with defineFlag and wire its readers.

    4.6k GitHub stars~780 tokensUpdated today
    Auto-check passed
  • Run App

    macro-inc/macro

    Run the Macro app on Cursor Cloud and pick up edits. An agent skill from macro-inc/macro.

    4.6k GitHub stars~712 tokensUpdated today
    Auto-check passed
  • Add SDK Endpoint

    macro-inc/macro

    Wrap a new backend endpoint in the TypeScript SDK (packages/sdk), or record it as skipped.

    4.6k GitHub stars~1k tokensUpdated today
    Auto-check: notes
  • Enforce hexagonal architecture in the Rust backend. An agent skill from macro-inc/macro.

    4.6k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Collab Surface Core

    macro-inc/macro

    A skill your agent uses when adding collaborative markdown, notes, or descriptions to a feature with collab surfaces.

    4.6k GitHub stars~639 tokensUpdated today
    Auto-check passed

Questions about Mintlify API

What does Mintlify API do?

Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically. Mintlify API is an agent skill from macro-inc/macro. Interact with the Mintlify REST API to manage deployments, trigger builds, and query documentation site metadata programmatically.

When should I use Mintlify API?

Mintlify API fits situations like: query documentation site metadata programmatically; tasks that involve Deployment; tasks that involve Static sites and blogs.

How do I install Mintlify API in Claude Code?

Run `npx skills add macro-inc/macro --skill mintlify-api -a claude-code`. Or copy the skill folder (apps/docs/.agents/skills/mintlify-api in macro-inc/macro) into .claude/skills/mintlify-api in your project. Claude Code loads it when a task matches its description.

How do I install Mintlify API in Codex?

Run `npx skills add macro-inc/macro --skill mintlify-api -a codex`. Or copy the skill folder (apps/docs/.agents/skills/mintlify-api in macro-inc/macro) into .agents/skills/mintlify-api in your project. Codex loads it when a task matches its description.

Can I use Mintlify API 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 macro-inc/macro --skill mintlify-api -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-api, .gemini/skills/mintlify-api, .github/skills/mintlify-api and .opencode/skills/mintlify-api in your project.

What does Mintlify API need to run?

SKILL.md names no scripts, command-line tools or credentials: Mintlify API is instructions for the agent only. Compatibility (from SKILL.md): Any HTTP client. Authentication via API key..

Does Mintlify API access the network?

SKILL.md names 2 domains. As links in the text: dashboard.mintlify.com and mintlify.com. This is read from the text; nothing was executed.

Is Mintlify API 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 API use?

Mintlify API is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mintlify API use?

About 333 tokens (SKILL.md is roughly 1.3k 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 API?

Skills that share tags, products or a category with Mintlify API: Frappe Ops Website Deploy (Impertio-Studio/Frappe_Claude_Skill_Package, 187 stars), Golem Add HTTP Endpoint Effect (golemcloud/golem, 1.5k stars), Ship Coolify (kovrichard/catalyst, 470 stars) and Finding Triage (HacktronAI/skills, 115 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mintlify API?

macro-inc (a GitHub organization) maintains it in macro-inc/macro, which has 4,578 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 7, 2026.

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