Agent skill sync with docs: playground expand and MCP code mode - #7216
Merged
Conversation
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
ethanpalm
approved these changes
Sep 2, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sync the canonical Mintlify agent skill with two authoritative documentation changes: the new
x-mintplaygroundexpandsetting and the admin MCP code mode tools.Changes
reference/api-docs.md: addx-mint.playground.expandto the OpenAPI extensions list (collapse nested object fields in the playground; request sections and the top-level body object stay expanded; expanded by default).SKILL.md: document the admin MCP code mode toolssearch_code_operationsandexecute_code, and clarify that content changes buffer on a session branch while deployment management changes made through code mode apply immediately to the live deployment without a branch or pull request.Context
api-playground/openapi-setup.mdx(Document x-mint playground expand setting #7164, refined in Fix grammar & typos: OpenAPI setup page corrections #7203/Apply brand tone and writing style fixes #7204) added thex-mint: playgroundexpand: falsesetting.ai/mintlify-mcp.mdx(Documentation quality check: fix gaps in recently changed pages #7139) added the Deployment management (code mode) section and its immediate-apply warning.Validation:
npm test,npm run check,npm run build, andgit diff --checkall passed. The existing sync workflow distributes the canonical skill to the Codex, Cursor, and Claude plugin copies after merge.Note
Low Risk
Documentation-only updates to agent skill reference files; no runtime, auth, or deployment code changes.
Overview
Updates the canonical Mintlify agent skill so agents match recent product docs: OpenAPI playground behavior and Admin MCP deployment management.
reference/api-docs.mddocumentsx-mint.playground.expand: setfalseon an operation to collapse nested object fields in the playground by default (auth/headers/query/path/body sections and the top-level body object stay expanded; default remains expanded).SKILL.mdaddssearch_code_operationsandexecute_codefor Admin MCP code mode (workflows, settings, members, billing, etc.) and clarifies that content edits still buffer on a session branch untilsave, while deployment management writes from code mode apply immediately to the live deployment with no checkout, branch, or PR.Reviewed by Cursor Bugbot for commit 600d5de. Bugbot is set up for automated code reviews on this repo. Configure here.