mastra

Reference guide for building agents and workflows with current Mastra APIs.

mastra-ai ↓ 25k

Claude Code

View source ↗

What it does

If packages exist: Use embedded docs first (most reliable)
If no packages: Install first or use remote docs
Agent: Use for open-ended tasks that make decisions and use tools.
Workflow: Use for defined multi-step processes.
Property X does not exist on type Y
Cannot find module
Type mismatch errors

Requirements & configuration

If no packages: Install first or use remote docs
Mastra requires ES2022 modules. CommonJS will fail. See references/create-mastra.md for setup and references/common-errors.md for troubleshooting.

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Reference guide for building agents and workflows with current Mastra APIs.

Source

Repository: https://github.com/mastra-ai/skills

mastra FAQ

What does the mastra skill do?

Comprehensive Mastra framework guide for building agents, workflows, tools, memory, workspaces, and storage with current APIs. Use for documentation lookup, API verification, TypeScript setup, common errors, migrations, and `mastra api` CLI tasks: inspect or call resources on local, Mastra platform, or remote servers. If packages exist: Use embedded docs first (most reliable) If no packages: Install first or use remote docs

What does mastra require?

If no packages: Install first or use remote docs Mastra requires ES2022 modules. CommonJS will fail. See references/create-mastra.md for setup and references/common-errors.md for troubleshooting.

How do I install mastra?

Run: npx -y skills add https://github.com/mastra-ai/skills --skill mastra --agent claude-code — the source lives at github.com/mastra-ai/skills.

Maintain mastra?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![mastra on getagentictools](https://getagentictools.com/badge/skills/mastra-ai-skills-mastra.svg)](https://getagentictools.com/skills/mastra-ai-skills-mastra?ref=badge)

npx agentictools info skills/mastra-ai-skills-mastra

The second line is the CLI lookup for this page — handy in READMEs and docs.