Skip to content

Agent skill sync with docs: clarify groups frontmatter with personalization - #6987

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/180cb44f
Open

Agent skill sync with docs: clarify groups frontmatter with personalization#6987
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/180cb44f

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 15, 2026

Copy link
Copy Markdown
Contributor

Summary

Align the canonical Mintlify skill with the newly documented standalone personalization feature, which changes how the groups page frontmatter field behaves.

Changes

  • agent-context/context/skills/mintlify/reference/configuration.md: rewrite the groups frontmatter row so it distinguishes authentication (restricts access) from standalone personalization (controls navigation visibility only; users can still open the page by direct URL).

Context

Upstream authoritative changes in the review window (2026-08-14 → 2026-08-15):

  • Document personalization and JWT login options #6959 "Document personalization and JWT login options" — introduced shared session / JWT / OAuth personalization and explicitly documented that with standalone personalization, groups in page frontmatter no longer restrict access, only navigation visibility (create/personalization.mdx, deploy/authentication-setup.mdx).

Other changes in the window were reviewed and intentionally not synced:

  • Editor product features (version history, live-preview site settings, main-branch autocommits) — outside skill scope.
  • Assistant support-link deflection and analytics thread endpoint — skill does not cover assistant admin config or analytics APIs.
  • Auth0 OAuth help-center article and self-hosted GitLab Pro+ plan note — no skill-level facts changed.
  • Structural pruning of what-is-mintlify / dashboard/permissions — not referenced by the skill.
  • lastUpdatedDate frontmatter and auto-route fallback — already synced in Agent skill sync with docs: lastUpdatedDate and auto-route fallback #6980.
  • Style-only edits (brand tone, Vale, API playground casing, changelog entry) — no behavior change.

Validation

Ran from agent-context/:

  • npm test (node --test): 5 passed, 0 failed.
  • npm run check: "All generated targets are valid and shared references are identical."
  • npm run build: emitted claude, codex, cursor, kiro working-tree targets.
  • git diff --check: clean.

The existing agent-context sync workflow will distribute the canonical skill to the Codex, Cursor, and Claude plugin repositories after merge.


Note

Low Risk
Documentation-only change in agent skill reference; no runtime or product behavior changes.

Overview
Syncs the canonical Mintlify agent skill with upstream docs on standalone personalization.

In configuration.md, the groups frontmatter row is rewritten so agents do not treat it as always access-restricting. With authentication, groups still restricts access. With standalone personalization, it only affects navigation visibility—users can still open the page via a direct URL.

Reviewed by Cursor Bugbot for commit 2a2a120. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Aug 15, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 15, 2026, 4:11 PM

@mintlify

mintlify Bot commented Aug 15, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Aug 15, 2026, 4:11 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant