SkillFoxx

Mastra Agent Skills

Official Mastra skills: an agent finds framework APIs in the docs, fixes common errors and walks through version migrations.

  • 104 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • The Factory skill reads deployment data and changes state only with user authorization.
  • Deploying with `mastra deploy` sends the project to an external platform.
All reasons and checks

mastra-ai/skillsAuthor:mastra-ai

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/mastra-agent-skills

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The Factory skill reads deployment data and changes state only with user authorization.
  • Deploying with `mastra deploy` sends the project to an external platform.

This is third-party code. Review the repository files before installing.

What it does

Two official skills for agents building applications on Mastra, a TypeScript framework for AI agents. The `mastra` skill guides project setup and looks up APIs in the embedded docs under `node_modules/@mastra/*/dist/docs/` or in `https://mastra.ai/llms.txt`. Separate sections cover common errors, version migrations, deployment to the Mastra Platform and trace queries. The `mastra-factory` skill connects an agent to your own deployment through `mastra api factory`. The agent reads queue summaries, sessions and work-item memory, and runs state-changing operations only with the user's authorization. The same set is served through the `.well-known` scheme at `https://mastra.ai/.well-known/skills/`.

Who it is for. Mastra developers who hand project setup, version upgrades and framework error triage to Claude Code or Cursor.

Good fit when

  • A new Mastra project is created from the command line and the agent needs current steps.
  • After upgrading `@mastra/*` packages the application no longer builds.
  • The agent has to find a method signature instead of guessing from memory.
  • The application ships to the Mastra Platform with `mastra deploy`.
  • A team inspects work queues and sessions through `mastra api factory`.

Not a fit when

  • The project uses a different agent framework.
  • The agent may not reach the network or Mastra services.
  • General questions about AI agents with no tie to this framework.

Example request

Create a Mastra project and wire in an agent with a search tool. If unsure about an API, open the embedded docs in `node_modules`.

Limitations

The skills cover only Mastra and are useless for other frameworks. Documentation lookup needs installed `@mastra/*` packages or access to `mastra.ai`. The `mastra-factory` skill works against your own Factory deployment and requires a CLI login. Global installation depends on the agent: PromptScript does not support it, and after installing you should confirm the skill is linked. The `mastra` skill can send bug reports to the Mastra team, and that needs explicit user consent.

How to disable. Remove the `mastra` and `mastra-factory` folders from the agent's skills directory, or undo the install with the same `npx skills` tool.

FAQ

What is in the repository?

Two skills: `mastra` for development and `mastra-factory` for working with Factory. The first ships reference files on setup, errors, migrations and the platform.

How do I install only the Factory skill?

`npx skills add mastra-ai/skills --skill mastra-factory` installs it alone. The tool asks interactively for the agent and scope.

Where does the skill get documentation?

First from `node_modules/@mastra/*/dist/docs/` of installed packages, then from `https://mastra.ai/llms.txt` when the local copy falls short.

How do I install globally?

Name the agent explicitly: `--agent <agent> -g`. Afterwards run `npx skills list -g` and check that reference links are present.

Does manual installation work?

Yes. Clone `https://github.com/mastra-ai/skills.git` and point the agent at skills from that folder.

Discussion

No questions or reviews yet.

Skills

Dozens of mizchi's agent skills: frontend audits, AWS, Cloudflare, SQL, Playwright and OpenTelemetry, installed one by one

SkillExtended access422

A vetted skill registry with a CLI that installs into twenty-plus agents and an MCP server for on-demand skill lookup

SkillExtended access7.2K

A library of 30-plus instruction skills for coding agents: planning, building, testing, hallucination guards and shipping

SkillMinimal access217

Builder Skills

Skills for agents

A set of small skills from Builder.io for agent work habits: visual plans and diff recaps, docs-first checks, cross-agent review and clean status updates

SkillExtended access4.7K

The author's personal set: shared agent rules and dozens of skills for GitHub, the browser, macOS, messaging and releases, plus a sync script

SkillBroad access7.5K

A set of independent skills against drift in large codebases: hard-cut, root-cause tracing, lean testing and CI right-sizing.

SkillMinimal access140

README in short

The `mastra` skill is split into reference files, so the agent opens the section matching the user's question instead of reading everything.

README badge

Report a problem