mastra-docs — скилл для Claude Code: документация Mastra
Скилл mastra-docs для Claude Code задаёт правила работы с документацией Mastra. Он подключается при создании и проверке страниц, сайдбаров, редиректов и компонентов документации.
Apache-2.0 165 установок ★ 29 724 обновлён 2026-11-14
npx skills add mastra-ai/mastra --skill mastra-docs -a claude-codeЧто делает mastra-docs
mastra-docs помогает создавать, редактировать, перемещать, удалять и проверять документацию Mastra. Он задаёт правила для страниц, сайдбаров, редиректов и компонентов документации.
В скилле собраны ссылки на руководства по стилю, информационной архитектуре, типам страниц, MDX-компонентам, диаграммам и рабочему процессу. Для новой страницы он предлагает выбрать шаблон по задаче читателя, сверить результат с примером и соседними страницами, а затем пройти чек-листы. Шаблон задаёт начальную структуру, а не жёсткую форму.
Для проверки документации используется команда pnpm check; отключать отдельные правила предлагают комментариями lint в коде. Если нужно заменить изображение диаграммы на Mermaid, скилл направляет к docs-diagrams.
Какие задачи решает
- создать страницу документации Mastra по подходящему шаблону
- проверить, к какому разделу и маршруту относится новая страница
- переместить страницу и учесть редиректы
- проверить MDX-компоненты и правила документации
Примеры запросов агенту
- Создай страницу о настройке функции Mastra и выбери подходящий шаблон.
- Проверь документацию Mastra и запусти
pnpm check. - Перемести страницу документации и обработай связанные редиректы.
Как установить mastra-docs
1Через Skills CLI (Vercel)
npx skills add mastra-ai/mastra --skill mastra-docs -a claude-code2Вручную: положить файлы
~/.claude/skills/mastra-docs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mastra-docs/
1Через Skills CLI (Vercel)
npx skills add mastra-ai/mastra --skill mastra-docs -a codex2Вручную: положить файлы
.agents/skills/mastra-docs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mastra-ai/mastra --skill mastra-docs -a cursor2Вручную: положить файлы
.cursor/skills/mastra-docs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mastra-ai/mastra .claude/skills/mastra-docs2Вручную: положить файлы
.github/skills/mastra-docs/SKILL.md1Через Skills CLI (Vercel)
npx skills add mastra-ai/mastra --skill mastra-docs -a gemini-cli2Командой платформы
gemini skills install https://github.com/mastra-ai/mastra --path .claude/skills/mastra-docsВручную: положить файлы
.devin/skills/mastra-docs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add mastra-ai/mastra --skill mastra-docs -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mastra-docs
Как установить mastra-docs в Claude Code?
Выполни npx skills add mastra-ai/mastra --skill mastra-docs -a claude-code. Файл скилла находится по пути ~/.claude/skills/mastra-docs/SKILL.md.
Что делает mastra-docs?
Скилл задаёт правила для создания и проверки документации Mastra, включая страницы, сайдбары, редиректы и компоненты. Он также помогает выбрать шаблон страницы по задаче читателя.
Как mastra-docs помогает выбрать шаблон страницы?
Шаблон выбирается по вопросу читателя: например, для конкретной задачи используется templates/how-to.md, а для работы с API или командой — templates/reference-api.md.
Исходный текст
SKILL.md · Apache-2.0
--- name: mastra-docs description: Documentation guidelines for Mastra. Use this skill when creating, editing, moving, deleting, or reviewing Mastra documentation, sidebars, redirects, or docs components. --- # 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. 7. `references/CHECKS.md`: The `pnpm check` command, rule IDs, JSON output, and inline `lint` comments for disabling rules. To replace an existing diagram image with Mermaid, use the `docs-diagrams` skill. ## Page templates When creating a page, pick the template that matches the reader's question: | Reader question | Template | Typical location | | -------------------------------------------------- | ---------------------------- | ---------------------------------------------- | | "What is this area, and which option fits?" | `templates/overview.md` | `/docs/<category>/overview` | | "What is this capability, and how do I set it up?" | `templates/concept.md` | `/docs/<category>/<feature>` | | "How do I accomplish this specific task?" | `templates/how-to.md` | `/docs/<category>/<task>` | | "What's the fastest way to see it working?" | `templates/quickstart.md` | `## Quickstart` in an overview or concept page | | "What does this API or command accept?" | `templates/reference-api.md` | `/reference/<category>/<api-or-command>` | | "How do I use Mastra with this product?" | `templates/integration.md` | `/integrations/<category>/<product>` | 1. Copy the template's skeleton into the new `.mdx` file and replace every `$PLACEHOLDER`. 2. Compare the result with the template's example page and with neighboring pages. Where the section has an established convention, follow it. 3. Remove optional sections the page doesn't need. 4. Before finishing, run `templates/CHECKLIST.md` and the template's own self-review checklist. Templates set the starting shape, not a fixed form. Match the reader's task and the conventions of the current section.
© mastra-ai · Apache-2.0 · mastra-ai/mastra