Mastra Agent Skills

Official Mastra skills for agents working with the Mastra framework. Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.

Installation

npx skills add mastra-ai/skills

Mastra also supports the .well-known skills discovery standard:

npx skills add https://mastra.ai/

Included skills

mastra

Single comprehensive skill for all Mastra development. Uses progressive disclosure with reference files covering:

• Setup & Installation (references/create-mastra.md): CLI and manual project setup
• Embedded Docs Lookup (references/embedded-docs.md): Find APIs in node_modules/@mastra/*/dist/docs/
• Remote Docs Lookup (references/remote-docs.md): Fetch from https://mastra.ai/llms.txt
• Troubleshooting (references/common-errors.md): Common errors and solutions
• Migrations (references/migration-guide.md): Version upgrade workflows

Main skill file teaches core concepts and routes to appropriate reference files based on user questions.

Manual installation

git clone https://github.com/mastra-ai/skills.git

Then configure your agent to load skills from the cloned directory.

.well-known skills discovery

This repository is served via the RFC 8615 Well-Known URI at https://mastra.ai/.well-known/skills/.

Agents can discover available skills by fetching:

• Index: https://mastra.ai/.well-known/skills/index.json
• Skills: https://mastra.ai/.well-known/skills/mastra/SKILL.md

This enables automatic skill discovery without manual configuration.

Contributing

Contributions welcome!

1. Fork the repository
2. Make improvements to SKILL.md files
3. Test with actual development workflows
4. Submit a pull request

Resources

• Mastra Docs
• Mastra GitHub
• Agent Skills Spec
• .well-known Skills RFC
• Discord

License

Apache-2.0 - See LICENSE for details