Mastra Framework Setup

This skill helps you set up and configure Mastra, a comprehensive TypeScript framework for building AI-powered applications and agents.

What This Skill Does

Sets up the Mastra framework (`@mastra/core`) in your project, including:

Instructions

When the user requests Mastra setup, follow these steps:

1. Assess Project Context

First, understand the user's project:

2. Install Dependencies

Install the core package and recommended dependencies:

```bash

npm install @mastra/core

```

Optionally install additional packages based on requirements:

3. Create Mastra Configuration

Create a central Mastra configuration file (e.g., `src/mastra/index.ts` or `mastra.config.ts`):

```typescript

import { Mastra } from '@mastra/core';

export const mastra = new Mastra({

// Configure components as needed

});

```

4. Set Up Core Components

Based on user requirements, configure:

**Agents**: If the user needs AI agents that can use tools and maintain conversations

**Workflows**: If the user needs to chain or orchestrate multiple AI operations

**Tools**: If agents need to interact with external systems or APIs

**Memory**: If agents need conversation history or semantic recall

**Storage**: If persisting data beyond in-memory storage

5. Add Environment Variables

Create or update `.env.local` with necessary API keys:

```env

LLM Provider (OpenAI, Anthropic, etc.)

OPENAI_API_KEY=your_key_here

or

ANTHROPIC_API_KEY=your_key_here

Vector Store (if using RAG)

PINECONE_API_KEY=your_key_here

Database (if using persistence)

DATABASE_URL=your_connection_string

```

6. Create Example Implementation

Provide a working example based on the user's use case:

7. Documentation Links

Point the user to relevant documentation:

Important Notes

Example Usage Scenarios

1. "Set up Mastra with a simple AI agent that can search the web"

2. "Initialize Mastra for a Next.js project with RAG capabilities"

3. "Create a Mastra workflow that processes documents in parallel"

4. "Configure Mastra with PostgreSQL storage and conversation memory"

5. "Set up Mastra agents with MCP tool integration"

Constraints