Skill28.7k repo starsupdated today

building-agents-using-mastra

This Claude Code skill demonstrates how to build AI agents using Mastra framework integrated with Composio tools. It provides code examples for creating agents that can access external services like GitHub through Composio's Tool Router, including implementation patterns for single-user agents, multi-user sessions with user isolation, and streaming responses with agentic step tracking.

View source Repository: composio

Install in Claude Code

Copy

git clone --depth 1 https://github.com/ComposioHQ/composio /tmp/building-agents-using-mastra && cp -r /tmp/building-agents-using-mastra/.claude/skills/building-agents-using-mastra ~/.claude/skills/building-agents-using-mastra

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Building Agents using Mastra with Composio

Build AI agents using Mastra with Composio Tool Router.

## Installation

```bash
npm install @composio/core @composio/mastra @mastra/core
```

**Find Latest Versions:**
```bash
npm view @mastra/core version
npm view @composio/mastra version
```

## Integration Method

**Mastra is an agentic provider** - use Tool Router for user isolation.

### Native Tools with Tool Router

```typescript
import { Composio } from '@composio/core';
import { MastraProvider } from '@composio/mastra';
import { Agent } from '@mastra/core/agent';

const composio = new Composio({
  apiKey: process.env.COMPOSIO_API_KEY,
  provider: new MastraProvider(),
});

async function createAgent(userId: string) {
  // Create session
  const session = await composio.create(userId, {
    toolkits: ['github'],
    manageConnections: true
  });

  const tools = await session.tools();

  // Create agent
  const agent = new Agent({
    id: 'github-agent',
    name: 'GitHub Agent',
    instructions: 'You manage GitHub repositories',
    model: 'openai/gpt-4o',
    tools: {
      ...tools,  // Spread Composio tools
    },
  });

  return agent;
}

const agent = await createAgent('user_123');
const result = await agent.generate({
  prompt: 'Create a GitHub issue titled "Bug Report"',
});

console.log(result.text);
```

### Streaming with Tool Router

```typescript
async function streamAgent(userId: string, prompt: string) {
  const session = await composio.create(userId, {
    toolkits: ['github'],
    manageConnections: true
  });

  const tools = await session.tools();

  const agent = new Agent({
    id: 'agent',
    model: 'openai/gpt-4o',
    tools: { ...tools },
    maxSteps: 10,
  });

  // Stream response
  const stream = await agent.stream({
    prompt,
    onStepFinish: (step) => {
      console.log('Step completed:', step);
    },
  });

  for await (const chunk of stream) {
    process.stdout.write(chunk);
  }
}
```

## Key Features

- **40+ Model Providers**: OpenAI, Anthropic, Google, Mistral, Groq, etc.
- **Autonomous Agents**: Solve open-ended tasks
- **Streaming Support**: Real-time responses
- **v1.0 Released**: January 2026 - production ready

## Key Resources

- **Mastra Docs**: https://mastra.ai/docs
- **Tool Router Guide**: `/building-agents`
- **Agents Guide**: https://mastra.ai/docs/agents/overview
- **GitHub**: https://github.com/mastra-ai/mastra

## Environment Variables

```bash
OPENAI_API_KEY=sk-...  # Or other model provider
COMPOSIO_API_KEY=...
```

## Next Steps

1. Use `/building-agents` for comprehensive guide
2. Check `ts/examples/mastra/` for complete examples
3. See [Mastra docs](https://mastra.ai/docs) for multi-provider routing