Documentation guidelines for Mastra. Use this skill when creating, editing, moving, deleting, or reviewing Mastra documentation, sidebars, redirects, or docs components.
Resources
1Install
npx skillscat add mastra-ai/mastra/mastra-docs Install via the SkillsCat registry.
We need to produce a 2-3 sentence plain-text summary, objective, factual, no marketing, no superlatives, no calls to action, natural prose, no bullet points, no headings, no markdown. At most 60 words. Should explain what skill does, what problem it solves, when to use it. From description: Documentation guidelines for Mastra. Use when creating, editing, moving, deleting, or reviewing Mastra documentation, sidebars, redirects, or docs components. Problem: ensures consistent documentation style, structure, and compliance with guidelines. When: when working on Mastra docs.
Mastra documentation guidelines
Follow the most specific AGENTS.md and use these references:
references/STYLEGUIDE.md: Global writing, accuracy, links, code, and accessibility rules.references/INFORMATION_ARCHITECTURE.md: Content families, canonical ownership, sidebars, and routes.- Choose the page guide:
references/DOC.md: Pages under/docs.references/GUIDE_INTEGRATION.md: Pages under/integrations.references/REFERENCE.md: Pages under/reference.
references/COMPONENTS.md: Shared MDX components and llms-txt markup.references/DIAGRAM.md: Mermaid diagram shapes, colors, layout, labels, and accessibility.references/AUTHORING_WORKFLOW.md: Editing, moves, deletions, redirects, and verification.
To replace an existing diagram image with Mermaid, use the docs-diagrams skill.
Treat page patterns as guidance rather than fixed templates. Match the reader's task and the conventions of the current section.