Skip to content

Document multi-skill support for .mintlify/skills/ directory#5214

Closed
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/multi-skill-docs-1775685488
Closed

Document multi-skill support for .mintlify/skills/ directory#5214
mintlify[bot] wants to merge 1 commit intomainfrom
mintlify/multi-skill-docs-1775685488

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 8, 2026

Summary

  • Updated ai/skillmd.mdx to document the new .mintlify/skills/ directory structure for defining multiple custom skills
  • Added "Multiple skills" subsection with directory layout example and behavior notes
  • Documented /skill.md redirect behavior when multiple skills exist
  • Updated intro paragraph to reference multi-skill support

Related: mintlify/mint#6949


Note

Low Risk
Documentation-only changes describing a new .mintlify/skills/ layout and redirect behavior; low risk aside from potential confusion if the described precedence/redirect differs from actual implementation.

Overview
Documents multi-skill custom skill support by updating ai/skillmd.mdx to reference the .mintlify/skills/ directory, adding a new Multiple skills section with an example layout and precedence note, and clarifying that /skill.md redirects to /.well-known/skills/index.json when multiple skills exist.

Also renames the section to Custom skill files and reframes guidance to cover both single-root skill.md and multi-skill setups.

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

@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 8, 2026, 9:58 PM

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify bot commented Apr 8, 2026

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

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Apr 8, 2026, 10:04 PM

@ethanpalm
Copy link
Copy Markdown
Collaborator

duplicate with #5213 (review)

@ethanpalm ethanpalm closed this Apr 8, 2026
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