К основному содержанию
скилл CX Codex

mastra-docs — скилл для Claude Code: документация Mastra

Скилл mastra-docs для Claude Code задаёт правила работы с документацией Mastra. Он подключается при создании и проверке страниц, сайдбаров, редиректов и компонентов документации.

Apache-2.0 165 установок ★ 29 724 обновлён 2026-11-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mastra-ai/mastra --skill mastra-docs -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/mastra-docs/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/mastra-docs/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
mastra Mastra Учит строить агентов, воркфлоу, инструменты и хранилище данных на Mastra. CX Codex +1 102 700установок mastra-factory Mastra Скилл mastra-factory для Claude Code и Codex, который делает mastra api factory рабочим пультом управления Factory. Подключается при первом входе, проверке статуса, разборе очередей и осмотре проектов. CX Codex +1 6 200установок migrating-mastra-to-pydantic-ai pydantic Скилл migrating-mastra-to-pydantic-ai для Claude Code и Codex переносит TypeScript-приложения на Mastra в Python с Pydantic AI. Срабатывает на коде с импортами @mastra/* или агентами, инструментами и воркфлоу Mastra. CX Codex +1 464установок mastra-hono agent-skills Скилл mastra-hono для Claude Code: сборка ИИ-агентов, инструментов и воркфлоу на Mastra v1 Beta с API-серверами на Hono. Покрывает агентную логику на TypeScript. CX Codex +1 397установок grill-with-docs Matt Pocock Скилл grill-with-docs проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. CX Codex +1 1 219 756установок remotion-docs remotion-dev Скилл remotion-docs для Claude Code, Codex и Cursor, который ищет свежую документацию по Remotion. Находит страницы через поисковый индекс и подтягивает их тексты в Markdown. CX Codex +1 358 600установок

Из того же набора6

react-best-practices Скилл react-best-practices для Claude Code, Cursor, Codex, GitHub Copilot и других агентов: 27 правил по 9 категориям оптимизации React. Подключается при написании, ревью или рефакторинге компонентов. CX Codex +1 2 900установок ralph-plan Скилл ralph-plan для Claude Code помогает по шагам составить команду ralph-loop через диалог и анализ кодовой базы. CX Codex +1 2 600установок e2e-tests-studio Скилл e2e-tests-studio автоматически генерирует Playwright E2E тесты при изменении компонентов playground. Тестирует не состояние интерфейса, а реальное поведение: сохранение данных, потоки данных, эффекты действий. CX Codex +1 2 500установок smoke-test Скилл smoke-test разворачивает проект Mastra через create-mastra и запускает смоук-тест Mastra Studio в Chrome. CX Codex +1 2 500установок tailwind-v4 Скилл tailwind-v4 для Tailwind CSS v4: показывает агенту CSS-first конфигурацию и ловит классы v3, которые компилируются, но в новом коде не нужны. CX Codex +1 120установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой