Repository navigation
Agent skill sync with docs: mint dev --host, admin MCP tool updates - #8007
Merged
Merged
Conversation
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
ethanpalm
approved these changes
Oct 23, 2026
ethanpalm
added a commit
that referenced
this pull request
Oct 23, 2026
#8007 edited agent-context/context/skills/mintlify/SKILL.md without running `npm run build:site-skill`, so the validate check has failed on main and every PR since. Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This branch was successfully deployed
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
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.
Brings the Mintlify agent skill in line with docs changes merged in the last day.
The skill now lists the
mint dev --hostflag,edit_pagebatching with aneditslist (up to 100, all or nothing), thenotRenderedfield onedit_pageandwrite_page,create_nodeupdating an existing page at the samepath(updated: true), and the newcommentparameter onsuggest_edit, which the review guidance now points to.Based on document mint dev --host flag, admin MCP edit_page batching and notRendered, create_node upsert for existing admin MCP pages and comment parameter on admin MCP suggest_edit.
Duplicate check: no open skill sync PR covers these, and the open "Update agent skill from mint client changes" automation PRs (#7993, #8002) touch unrelated facts.
Validation:
git diff --checkpassed;npm test,npm run checkandnpm run buildcould not run because package tooling is unavailable in this environment.Note
Low Risk
Documentation-only updates to agent skill markdown; no runtime, auth, or product code changes.
Overview
Updates the Mintlify agent skill reference so agents see the same Admin MCP and CLI behavior as the main docs.
Admin MCP (
SKILL.md): Documentsedit_pagebatching via aneditslist (up to 100, transactional),notRenderedonedit_page/write_page,create_nodeupsert when a page already exists atpath(updated: true), and an optionalcommentonsuggest_edit. Key-tool bullets are reformatted from em dashes to colons for consistency.CLI (
reference/cli.md): Addsmint dev --hostso the local preview can be reached from other devices on the network.Review workflow (
reference/publishing-and-review.md): Directs agents to put suggestion rationale insuggest_edit’scommentparameter instead of a vague “in the suggestion itself.”Reviewed by Cursor Bugbot for commit 16f5ee8. Bugbot is set up for automated code reviews on this repo. Configure here.