Co-authored-by: Mastra Code (openai/gpt-5.6-sol) <noreply@mastra.ai>
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 innode_modules/@mastra/*/dist/docs/ - Remote Docs Lookup (
references/remote-docs.md): Fetch fromhttps://mastra.ai/llms.txt - Troubleshooting (
references/common-errors.md): Common errors and solutions - Migrations (
references/migration-guide.md): Version upgrade workflows - Trace Intelligence (
references/trace-intelligence.md): Query recurring themes across agent traces on the Mastra platform
Main skill file teaches core concepts and routes to appropriate reference files based on user questions.
mastra-factory
Standalone Factory supervisor skill for coding agents using mastra api factory. Covers read-only project and queue summaries plus interactive or autonomously delegated operations over work items, metrics, health, decisions, attention, and supervisor state.
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 - Mastra skill:
https://mastra.ai/.well-known/skills/mastra/SKILL.md - Factory skill:
https://mastra.ai/.well-known/skills/mastra-factory/SKILL.md
This enables automatic skill discovery without manual configuration.
Contributing
Contributions welcome!
- Fork the repository
- Make improvements to
SKILL.mdfiles - Test with actual development workflows
- Submit a pull request
Resources
License
Apache-2.0 - See LICENSE for details