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.

npx skills add mastra-ai/skills

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

npx skills add https://mastra.ai/

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
• Mastra API CLI (references/mastra-api.md): Inspect and call resources on local, platform, or remote servers
• Advanced Trace Queries (references/trace-query.md): Select completed traces with recursive predicates and cursor pagination
• Feedback (references/feedback.md): report verified bugs and concrete documentation defects to the Mastra team

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

Standalone Factory supervisor skill for coding agents using mastra api factory. Covers first-use CLI/login checks and URL-based connection from any directory, project and queue summaries, work-item session/thread and memory inspection, health interpretation, and user-authorized operations.

• Connection and installation: connect to your own deployment without a repository or project link file; choose the correct agent and installation scope.
• Session and memory inspection: find your work, inspect progress and OM evidence, and distinguish findings from repair authorization.
• Supervisor commands: contracts, output control, and safe mutations.

Install just the Factory skill with interactive agent/scope selection:

npx skills add mastra-ai/skills --skill mastra-factory

For a global install, specify your supported agent explicitly (--agent <agent> -g). PromptScript does not support global installation; use project scope for that agent instead, and confirm the skill is linked (a copied-but-"not linked" result means it is not active yet). Multi-agent installs can partially succeed: verify the intended agent with npx skills list (add -g for global scope) and confirm its skill references are present.

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

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

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.

Contributions welcome!

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

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

Apache-2.0 - See LICENSE for details