Skip to content

Document multi-skill support via .mintlify/skills/ directory#5215

Closed
mintlify[bot] wants to merge 2 commits intomainfrom
mintlify/multi-skill-docs-1775685507
Closed

Document multi-skill support via .mintlify/skills/ directory#5215
mintlify[bot] wants to merge 2 commits intomainfrom
mintlify/multi-skill-docs-1775685507

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify bot commented Apr 8, 2026

Summary

  • Updated the custom skill.md section to document the new .mintlify/skills/ directory structure for defining multiple custom skills
  • Added directory layout example, slug derivation explanation, and note about AI generation skip behavior
  • Preserves existing single root skill.md documentation

Relates to mintlify/server#4477


Note

Low Risk
Documentation-only updates describing an additional configuration option; no runtime code changes or behavioral risk beyond potential user confusion if misunderstood.

Overview
Updates the ai/skillmd.mdx docs to describe custom multi-skill support via .mintlify/skills/, including the expected directory layout (SKILL.md per subfolder), slug sanitization rules, and how conflicts/manifest generation are handled.

Clarifies precedence between a root skill.md and .mintlify/skills/ (custom skills disable AI-generated replacement), and generalizes wording from “custom skill.md” to “custom skill files” in the frontmatter section.

Reviewed by Cursor Bugbot for commit b7438be. 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:03 PM

@ethanpalm
Copy link
Copy Markdown
Collaborator

duplicate with #5213 (review)

@ethanpalm ethanpalm closed this Apr 8, 2026
@ethanpalm ethanpalm deleted the mintlify/multi-skill-docs-1775685507 branch April 8, 2026 23:09
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