Skip to content

Document multi-skill support#5221

Open
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/multi-skill-support-1775693398
Open

Document multi-skill support#5221
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/multi-skill-support-1775693398

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 9, 2026

Summary

  • Documents the new .mintlify/skills/ directory for defining multiple skill files per project
  • Explains directory structure, slug derivation rules, and frontmatter usage for multi-skill setups
  • Notes that auto-generated skill.md is skipped when custom skills are provided

Shipped: Users can now organize multiple SKILL.md files in .mintlify/skills/ subdirectories so agents can discover and load individual skills instead of a single monolithic file.


Note

Low Risk
Documentation-only change describing a new directory convention and slug/frontmatter behavior; no runtime code paths are modified.

Overview
Adds documentation for defining multiple agent skill files via a .mintlify/skills/ directory (one SKILL.md per subdirectory), including an example layout.

Clarifies behavior when custom skills are present (skips auto-generated root skill.md, but can merge with an optional root skill.md), explains slug derivation rules, and notes how name/description populate the discovery manifest for multi-skill setups.

Reviewed by Cursor Bugbot for commit 8d8ca59. 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, 12:13 AM

@mintlify-development
Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated (UTC)
userauth 🟡 Building Apr 9, 2026, 12:11 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