Yujohn Nattrass
31ef7d5376
Separate CLI schema discovery from canonical predicate documentation so agents validate command availability and do not infer unsupported operators. Remove deprecated grouping guidance to keep the skill focused on trace results. Co-Authored-By: mastra-platform[bot] <284800079+mastra-platform[bot]@users.noreply.github.com>
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 - 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 - 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