# Mastra Docs

Documentation guidelines for Mastra.

- Repository: https://github.com/mastra-ai/mastra (29259 stars)
- Category: Writing
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mastra-ai/mastra --skill mastra-docs -g -a claude-code -y`
Codex: `npx skills add mastra-ai/mastra --skill mastra-docs -g -a codex -y`
Cursor: `npx skills add mastra-ai/mastra --skill mastra-docs -g -a cursor -y`
Gemini CLI: `npx skills add mastra-ai/mastra --skill mastra-docs -g -a gemini-cli -y`

## Description

Documentation guidelines for Mastra. Use this skill when creating, editing, moving, deleting, or reviewing Mastra documentation, sidebars, redirects, or docs components.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Mastra documentation guidelines

Follow the most specific `AGENTS.md` and use these references:

1. `references/STYLEGUIDE.md`: ISO 24495-1 plain-language principles, accuracy, links, code, and accessibility.
2. `references/INFORMATION_ARCHITECTURE.md`: Content families, canonical ownership, sidebars, and routes.
3. Choose the page guide:
   - `references/DOC.md`: Pages under `/docs`.
   - `references/GUIDE_INTEGRATION.md`: Pages under `/integrations`.
   - `references/REFERENCE.md`: Pages under `/reference`.
4. `references/COMPONENTS.md`: Shared MDX components and llms-txt markup.
5. `references/DIAGRAM.md`: Mermaid diagram shapes, colors, layout, labels, and accessibility.
6. `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.