mastra-best-practices
Mastra Best Practices
Quick reference for Mastra conventions. See mastra.ai/docs for details.
Agent vs Workflow
| Use | When |
|---|---|
| Agent | Open-ended tasks (support, research) - reasons, decides tools, retains memory |
| Workflow | Defined sequences (pipelines, approvals) - orchestrates specific steps in order |
TypeScript Config (Required)
{
More from mastra-ai/skills
mastra
Comprehensive Mastra framework guide. Teaches how to find current documentation, verify API signatures, and build agents and workflows. Covers documentation lookup strategies (embedded docs, remote docs), core concepts (agents vs workflows, tools, memory, RAG), TypeScript requirements, and common patterns. Use this skill for all Mastra development to ensure you're using current APIs from the installed version or latest documentation.
15.7Kcreate-mastra
Complete project setup guide for Mastra AI framework. Covers: CLI installation (create-mastra), manual installation, TypeScript configuration (ES2022 requirements), environment setup, adding to existing projects (Next.js, Express), troubleshooting (module not found, import errors, CommonJS issues), deployment preparation, and monorepo configuration. Includes both quick setup (user runs CLI) and automatic setup (step-by-step file creation). Use this skill for all Mastra installation and setup questions to ensure correct configuration and prevent common errors.
90mastra-embedded-docs-look-up
Look up current API signatures from installed Mastra packages in node_modules/@mastra/*/dist/docs/. Use this skill to verify exact parameters, constructor arguments, and function signatures that match the installed version. Mastra APIs evolve rapidly - embedded docs ensure accuracy. Covers: Agent constructor parameters, Workflow API, Tool API, Memory configuration, Storage options, and all @mastra/* package exports. Returns actual TypeScript definitions and JSDoc from installed packages. Always use for API verification questions to prevent outdated answers.
67mastra-embeded-docs-look-up
Look up Mastra API documentation embedded in node_modules/@mastra/*/dist/docs/ for accurate API signatures. Use for Agent, Workflow, Tool, Memory configuration questions and code validation.
41