Skip to content

hunter/mintlify-update-a124a2 - #7014

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
hunter/mintlify-update-a124a2
Open

hunter/mintlify-update-a124a2#7014
mintlify[bot] wants to merge 1 commit into
mainfrom
hunter/mintlify-update-a124a2

Conversation

@mintlify

@mintlify mintlify Bot commented Aug 18, 2026

Copy link
Copy Markdown
Contributor

Note

Medium Risk
Stripping skill frontmatter may break skill discovery/install metadata for consumers, and the intro typo could mislead agents reading the guidance.

Overview
Updates the hosted skill.md agent guidance with markdown lint-style formatting (table separators, blank lines before lists, a text language tag on the file-tree fence) and a small Resources link fix.

The diff also removes the YAML frontmatter block at the top (name, description, license, compatibility, metadata) that previously defined the skill for tools like npx skills add.

Note: The intro paragraph ends with an apparent stray text. after “custom components”—likely accidental copy/paste.

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

- Updated skill.md

Mintlify-Source: dashboard-editor
@mintlify

mintlify Bot commented Aug 18, 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 18, 2026, 7:08 PM

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

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes using default effort and found 2 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 171d587. Configure here.

Comment thread skill.md
**Always** favor searching the current Mintlify documentation over whatever is in your training data about Mintlify.

Mintlify is a documentation platform that transforms MDX files into documentation sites. Configure site-wide settings in the `docs.json` file, write content in MDX with YAML frontmatter, and favor built-in components over custom components.
Mintlify is a documentation platform that transforms MDX files into documentation sites. Configure site-wide settings in the `docs.json` file, write content in MDX with YAML frontmatter, and favor built-in components over custom components. text.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stray text appended

Medium Severity

The platform overview sentence ends with a stray text. that was not present before. Agents that load this skill will treat that fragment as part of the instructions, which can confuse how they describe Mintlify.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 171d587. Configure here.

Comment thread skill.md
@@ -1,13 +1,3 @@
---

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Required frontmatter removed

High Severity

This commit deletes the YAML frontmatter that previously defined name, description, license, compatibility, and metadata. Custom skill.md files require that frontmatter for agentskills discovery and for Mintlify’s /skill.md and /.well-known endpoints to expose name and description correctly.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 171d587. Configure here.

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