mastra

Verify current Mastra APIs before writing or fixing TypeScript code.

Updated May 28, 2026
One-click install
npx skills add https://github.com/haryelramalho/skills --skill mastra-haryelramalho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mastra
Source: https://github.com/haryelramalho/skills/tree/main/skills/curated/mastra
Command: npx skills add https://github.com/haryelramalho/skills --skill mastra-haryelramalho

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Mastra changes quickly, and this Skill prevents outdated API usage by forcing you to verify the current documentation before writing or fixing code. It helps you avoid broken constructors, stale patterns, and version-mismatch errors when building AI applications.

Core Features & Use Cases

  • Current API verification: Looks up the right agent, workflow, tool, memory, and RAG signatures before implementation.
  • Documentation lookup strategies: Uses installed package docs first, then source maps or remote markdown docs when local packages are unavailable.
  • Troubleshooting and migration support: Helps diagnose common build, module, storage, model, and memory errors, and guides version upgrades.
  • Use case: A developer wants to create a weather agent, wire it to a tool, and test it in Studio without relying on obsolete examples.

Quick Start

Ask for help building or debugging your Mastra project and have the skill verify the current installed or remote documentation before generating any code.

Frequently Asked Questions about mastra

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify current Mastra APIs before writing agent or workflow code?

Verify current Mastra APIs by checking installed package documentation first, then falling back to source maps or remote markdown docs. This prevents outdated constructor signatures and broken implementations when building agents or workflows.

Why does my Mastra agent throw errors related to outdated framework patterns?

Mastra changes quickly, causing outdated API usage and broken constructors. Troubleshoot these build, module, storage, model, and memory errors by looking up the current documentation to ensure your implementation matches the latest framework signatures.

What is the best way to build a Mastra weather agent wired to a tool without using obsolete examples?

The best way to build a Mastra weather agent is to force verification of the current tool and agent signatures via embedded docs lookup before implementation. This ensures you use active API patterns instead of obsolete examples.

Do I need TypeScript ES2022 modules to implement Mastra agents and workflows?

Yes, TypeScript ES2022 modules are required for implementing Mastra agents and workflows. This environment setup supports the embedded docs lookup and remote markdown documentation strategies needed to verify current APIs.

How do I handle Mastra version upgrades and migration for RAG and memory tasks?

Handle Mastra version upgrades and migration by diagnosing common build, module, storage, and memory errors. Verify the current API signatures for RAG and memory tasks against installed packages or remote documentation to prevent version-mismatch issues.