Agent skill sync with docs: add seo.paths folder-scoped meta tags - #7513
Merged
Merged
Conversation
Contributor
Author
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
ethanpalm
approved these changes
Sep 25, 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
Adds the new
seo.pathsdocs.json field to the canonical Mintlify skill's configuration reference.Changes
reference/configuration.md: SEO example now includesseo.paths. A new bullet covers entry fields (path,metatags), path rules, precedence (seo.metatags<seo.pathswith longer path winning < frontmatter), language-folder matching, and thatcanonicalinpathsentries is ignored.Context
organize/settings-seo.mdx(Update from code changes: document seo.paths folder-scoped meta tags #7462, document seo.paths folder-scoped meta tags).projectsterminology change #7501), editor, assistant, agent, and GitLab pages.Validation
git diff --checkpassed. I reviewed the diff and it contains no unrelated changes.npm test,npm run check, andnpm run buildcould not be run successfully. Each one fails withERR_MODULE_NOT_FOUNDfor theajvdev dependency, which isn't installed in the run environment. The change only touches Markdown, and the code fences are balanced. Please run these commands in CI or locally before merging.The existing agent-context sync workflow will distribute the canonical skill to the plugin repositories after merge.
Note
Low Risk
Markdown-only sync to agent skill docs; no runtime or product code changes.
Overview
Updates the canonical Mintlify agent skill configuration reference so agents know about folder-scoped SEO meta tags via
seo.pathsindocs.json.The SEO example now includes a
pathsarray (e.g.guides/v1withrobots: noindex). New guidance covers entry shape (path,metatags), URL-based folder matching (including per-language paths), merge order (seo.metatags→ matchingseo.paths→ page frontmatter, with longer paths winning), and thatcanonicalinpathsentries is ignored.Reviewed by Cursor Bugbot for commit 943b36c. Bugbot is set up for automated code reviews on this repo. Configure here.