Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion agent-context/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,4 +63,4 @@ Every qualifying push to `main` validates the source and opens or updates the `a

Edit shared knowledge and MCP definitions in `context/`, not in generated plugin copies. Put a value in `targets/` only when a client requires a different packaging format.

The build rejects retired CLI commands. Tests verify that the skill, detailed references, and MCP definitions remain semantically identical across targets.
Tests verify that the skill, detailed references, and MCP definitions remain semantically identical across targets.
4 changes: 2 additions & 2 deletions agent-context/context/skills/mintlify/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Read these files **only when your task requires them**. They are in the `referen
| `reference/configuration.md` | Changing docs.json settings (theme, colors, logo, fonts, appearance, navbar, footer, banner, redirects, SEO, integrations, API config). Also covers snippets, hidden pages, .mintignore, custom CSS/JS, and the complete frontmatter fields table. |
| `reference/navigation.md` | Modifying site navigation structure (groups, tabs, anchors, dropdowns, products, versions, languages, OpenAPI, and SDK references in nav). |
| `reference/api-docs.md` | Setting up API documentation (OpenAPI, AsyncAPI, MDX manual API pages, extensions, playground config). |
| `reference/cli.md` | Running common CLI commands (dev, validate, add-domain, automations, analytics, score, broken-links, a11y, format, and config) and their key flags. |
| `reference/cli.md` | Running common CLI commands (dev, validate, add-domain, analytics, score, broken-links, a11y, format, and config) and their key flags. |
| `reference/product-context.md` | Before substantial content work (new site, broad restructure, first-time section setup) — check for and maintain `.mintlify/product-brief.md`. |

## MCP servers
Expand Down Expand Up @@ -220,7 +220,7 @@ Use `<Columns>` to arrange cards (or other content) in a grid. `cols` accepts 1-

## CLI commands

Install with `npm i -g mint`. Key commands: `mint dev` (local preview), `mint validate`, `mint broken-links`, `mint a11y`, `mint test` (generate tests for code blocks), `mint score`, `mint automations`, `mint new`, `mint signup`, `mint index` (install the Mintlify Index MCP server in supported coding agents). Read `reference/cli.md` for full flags and subcommands.
Install with `npm i -g mint`. Key commands: `mint dev` (local preview), `mint validate`, `mint broken-links`, `mint a11y`, `mint test` (generate tests for code blocks), `mint score`, `mint analytics` (traffic, search, feedback, and assistant conversations; Pro and Enterprise plans), `mint new`, `mint signup`, `mint index` (install the Mintlify Index MCP server in supported coding agents). Read `reference/cli.md` for full flags and subcommands.

## Writing standards

Expand Down
8 changes: 0 additions & 8 deletions agent-context/context/skills/mintlify/reference/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,14 +78,6 @@ Query documentation analytics from the terminal. Requires `mint login`. All `min
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | Global only |
| Zed | User `settings.json` | `.zed/settings.json` |

## Automations

All `mint automations` subcommands share these flags: `--subdomain`, `--format` (table/json; default: table). `mint workflow` and `mint workflows` continue to work as aliases.

- `mint automations create` — Create an automation. Requires exactly one trigger: `--cron <expr>` for scheduled or `--push-repo <owner/repo>` (repeatable) for push-triggered. Key flags: `--name`, `--type` (one of `changelog`, `source-code-agent`, `translations`, `writing-style`, `typo-check`, `broken-link-detection`, `seo-metadata-audit`, `assistant-docs-updates`, `contextual-feedback-docs-updates`; omit for custom), `--prompt`, `--context-repo` (repeatable, up to 10), `--automerge`, `--file <path>` (JSON/YAML file overrides inline flags).
- `mint automations list` — List automations for the current deployment.
- `mint automations delete <id>` — Delete an automation by ID. Use `mint automations list` to get the ID.

## Maintenance

- `mint update` — Update the CLI to the latest version.
Expand Down
3 changes: 0 additions & 3 deletions agent-context/scripts/lib.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -126,9 +126,6 @@ function validateSkill(skill, target) {
if (!/^name: mintlify$/m.test(skill) || !/^description: .+$/m.test(skill)) {
throw new Error(`${target.id}: SKILL.md requires name and description fields`);
}
if (/mint analytics/.test(skill)) {
throw new Error(`${target.id}: SKILL.md contains retired CLI commands`);
}
}

export async function buildTarget(target, outputRoot) {
Expand Down
3 changes: 1 addition & 2 deletions agent-context/test/build.test.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -52,8 +52,7 @@ test('builds all client variants from one canonical skill', async () => {
assert.match(skill, /### Mintlify Search/);
assert.match(skill, /### Mintlify Admin/);
assert.match(skill, /Complete authentication in the browser when prompted/);
assert.match(skill, /mint automations/);
assert.doesNotMatch(skill, /mint analytics|mint workflow|\{\{/);
assert.doesNotMatch(skill, /\{\{/);
}
assert.deepEqual(codexMcp.mcp_servers, cursorMcp.mcpServers);
assert.deepEqual(claudeMcp.mcpServers, cursorMcp.mcpServers);
Expand Down
Loading