Skip to content

Agent skill sync with docs: fix MDX table of contents fact - #7196

Merged
ethanpalm merged 1 commit into
mainfrom
mintlify/99d5b22b
Aug 31, 2026
Merged

Agent skill sync with docs: fix MDX table of contents fact#7196
ethanpalm merged 1 commit into
mainfrom
mintlify/99d5b22b

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Summary

Sync the canonical Mintlify agent skill with a corrected fact about the <MDX> component's table of contents behavior.

Changes

  • agent-context/context/skills/mintlify/reference/components.md: headings inside <MDX> do appear in the page's table of contents, including headings in branches that never render (such as the inactive side of a conditional). The skill previously stated the opposite.

Context

  • Caused by components/mdx.mdx in commit df901bb (Documentation quality check: fix gaps in recently updated pages #7190), which reversed the previous claim that <MDX> headings are excluded from the table of contents.
  • Other changes in that window (BYOM description wording, task list Markdown section, editor appearance settings, glossary entry) do not affect facts taught by the skill.
  • Validation: npm test, npm run check, npm run build, and git diff --check all passed.
  • The existing sync workflow will distribute the canonical skill to plugin repositories after merge.

Note

Low Risk
Documentation-only correction in the agent skill reference; no runtime or security impact.

Overview
Updates the canonical Mintlify agent skill so the <MDX> notes match current product behavior: headings inside <MDX> do show up in the page table of contents, including headings in conditional branches that are not rendered (e.g. the inactive platform branch).

This replaces the previous skill text that incorrectly said those headings are excluded from the TOC, aligning agent-context/context/skills/mintlify/reference/components.md with components/mdx.mdx after the docs change in #7190.

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

@mintlify

mintlify Bot commented Aug 31, 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 31, 2026, 4:13 PM

@mintlify

mintlify Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
tomee 🟡 Building Aug 31, 2026, 4:11 PM

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

@ethanpalm
ethanpalm merged commit c9cf5f4 into main Aug 31, 2026
6 checks passed
@ethanpalm
ethanpalm deleted the mintlify/99d5b22b branch August 31, 2026 16:22
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