CtrlK
BlogDocsLog inGet started
Tessl Logo

mastra-docs

Documentation guidelines for Mastra. This skill should be used when writing or editing documentation for Mastra. Triggers on tasks involving documentation creation or updates.

69

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Mastra Documentation Guidelines

Use this skill when you create or update Mastra docs. Keep the docs clear and consistent. Follow the most specific AGENTS.md for the area you change. After making your changes to the docs and sidebars, run the linters to check your work.

Styleguides

Start with references/STYLEGUIDE.md for all docs. Then use the guide that matches the content:

  • references/DOC.md - General docs that do not fit the categories below
  • Choose the right guide for the file's content:
    • references/GUIDE_QUICKSTART.md - Quickstarts that help readers get working fast with a specific library or framework
    • references/GUIDE_TUTORIAL.md - Tutorials that teach readers how to build something with Mastra
    • references/GUIDE_INTEGRATION.md - Integration guides for using Mastra with an external library or ecosystem
    • references/GUIDE_DEPLOYMENT.md - Deployment guides for shipping a Mastra app to a platform
  • references/REFERENCE.md - Reference and API docs

Linting

Use these tools to keep docs consistent:

  • oxfmt - Formats docs code, Markdown, config, and style files through the docs-local config.
  • prettier - Formats MDX through the docs-local custom parser so admonitions, JSX expressions, and fenced code blocks remain supported.
  • remark - Checks markdown issues like heading levels, list styles, and formatting consistency. This is the middle layer.
  • vale - Checks grammar, style, and wording. This is the top layer.

Run these commands in docs/:

  • pnpm run format - Format docs files with oxfmt and docs-local Prettier for MDX.
  • pnpm run format:check - Check docs formatting with oxfmt and docs-local Prettier for MDX.
  • pnpm run lint:remark - Check markdown with Remark
  • pnpm run lint:vale:ai - Check prose with Vale using the error alert level
  • pnpm run validate - Check frontmatter values and if all sidebars are valid
  • pnpm run generate-vercel-redirects - Generate vercel.json redirects after editing vercel.redirects.json
Repository
mastra-ai/mastra
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.