Agent skill sync with docs: GitHub component, OpenAPI file uploads, playground JS

[mintlify]

Summary

Sync the canonical Mintlify skill with behavior additions from authoritative English docs between 2026-08-10 and 2026-08-11.

Changes

• reference/components.md: document the new <GitHub.Repo> component with its repo, variant (inset | flat), and className props.
• reference/api-docs.md: add an OpenAPI 3.1 file-upload section (binary contentMediaType, contentEncoding rules, legacy format support) and a runtime server variables section for window.mintlify.api.playground.setServerVariables / clearServerVariables.

Context

Driven by authoritative doc changes in the window:

• components/github.mdx (Update from code changes: document GitHub repository card #6923, add new badges for widget and github repo component #6940) — new <GitHub.Repo> component.
• api-playground/openapi-setup.mdx (Update from code changes: document OpenAPI file uploads #6863) — OpenAPI 3.1 file upload behavior.
• customize/custom-scripts.mdx (Update from code changes: document API Playground variables #6882) — window.mintlify.api.playground.setServerVariables / clearServerVariables JS APIs.

Other in-window changes were reviewed but did not affect facts the skill already teaches:

• Bitbucket Cloud support (Bitbucket cloud support #6929), multi-repo sourceRef in menu (Update from code changes: sourceRef in tab menu arrays #6901), static export .html URLs (Update from code changes: document static export URLs #6875), Pylon/Zendesk support automation (Update from code changes: support Pylon and Zendesk feedback #6917), user flow / analytics restructure (Update from code changes: document user flows #6855, Split analytics page into a group #6944, #3b78dd9d), download-spec auth warning (Warn that download-spec on authed sites bypasses auth groups #6939), editor comments/suggestions (Editor comments & suggestions #6924), task-list / private-page editor updates (Add task lists and moving private pages to editor docs #6932), local workflow deprecation, translation-only PRs, brand-tone / SEO polish.

Validation

npm test, npm run check, npm run build, and git diff --check all passed. 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 changes to agent skill markdown; no product code or configuration behavior is modified in this PR.

Overview
Updates the canonical Mintlify agent skill reference so it matches recent product docs—no runtime code changes.

reference/components.md adds documentation for <GitHub.Repo>: a public-repo card that loads description, stars, and forks via the GitHub API, with repo, variant (inset | flat), and className props.

reference/api-docs.md adds an OpenAPI 3.1 file uploads section (binary contentMediaType in multipart/form-data, contentEncoding behavior, legacy format: binary / base64) and a runtime server variables section for window.mintlify.api.playground.setServerVariables / clearServerVariables (session-scoped prefills after load, not for secrets).

^{Reviewed by Cursor Bugbot for commit 19f81e8. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

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

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

[mintlify]

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

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

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