Skip to content

Document multi-skill support#5228

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/multi-skill-docs-1775699766
Open

Document multi-skill support#5228
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/multi-skill-docs-1775699766

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 9, 2026

Summary

  • Documents the new multi-skill feature that lets users define multiple skill files in .mintlify/skills/*/SKILL.md instead of a single root skill.md
  • Explains the directory structure, behavior when multiple skills exist (redirect from /skill.md to the discovery index), and precedence rules
  • Shipped in mintlify/mint#6949: adds support for serving multiple custom skill files via the .mintlify/skills/ directory with full backward compatibility for single skill.md

Note

Low Risk
Documentation-only change describing how to structure and discover multiple SKILL.md files; no runtime or behavior changes in this PR.

Overview
Documents multi-skill support for skill.md by describing how to place multiple SKILL.md files under .mintlify/skills/*/SKILL.md.

Clarifies discovery behavior (including /skill.md redirecting to /.well-known/skills/index.json), per-skill URLs derived from frontmatter name, and precedence when both a root skill.md and .mintlify/skills/ exist.

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

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 9, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 9, 2026, 2:00 AM

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.

0 participants