Repo No. 72Mastra · Updated 21 September 2026 · In print

Skills Docs · No. 72

Mastra

mastra-ai / skills

Official agent skills for coding agents working with the Mastra AI framework

Start reading — 2 min

2 skills1,310 words

Inside this issue

1 — Install

$ npx skills add mastra-ai/skills

» /plugin marketplace add mastra-ai/skills

Other86 stars1,310 wordsUpdated 21 September 2026

2 — Skills

2 skills · 6 minutes

Mastra FactoryOperate and supervise Mastra Factory through mastra api factory.2 min
MastraComprehensive Mastra framework guide for building agents, workflows, tools, memory, workspaces, and storage…4 min

Skills Docs · Repo No. 72Whole repo as markdown

Provenance

Weekly installs — mastra-ai/skills8 weekly install buckets for mastra-ai/skills, ending 3.7K above where it began. Highest week 4.7K, lowest 916.55.2Kinstalls

Weekly installs — mastra-ai/skills. 8 weekly install buckets for mastra-ai/skills, ending 3.7K above where it began. Highest week 4.7K, lowest 916.
Week	Installs
Week 1	916
Week 2	1,424
Week 3	3,380
Week 4	3,693
Week 5	3,620
Week 6	4,445
Week 7	4,690
Week 8	4,665

Typeset in this issue’s own colours, resolved from the owner’s published design.md.

Front matter

From the README

Mastra Agent Skills

Official Mastra skills for agents working with the Mastra framework (opens in a new tab). 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 (opens in a new tab):

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
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.

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 (opens in a new tab): connect to your own deployment without a repository or project link file; choose the correct agent and installation scope.
Session and memory inspection (opens in a new tab): find your work, inspect progress and OM evidence, and distinguish findings from repair authorization.
Supervisor commands (opens in a new tab): 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.

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 (opens in a new tab) 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.md files
Test with actual development workflows
Submit a pull request

Resources

License

Apache-2.0 - See LICENSE (opens in a new tab) for details

Colophon

How this issue was made

Source

github.com/mastra-ai/skills, branch main, last pushed 21 September 2026.

Licence

Other — the text of every skill is reproduced unmodified, frontmatter included, under the upstream licence.

Discovery

2 skills found by walking the repository tree for SKILL.md, not by matching a directory convention. One layout observed: skills/*/SKILL.md.

Issue colours

Resolved from the owner’s published design.md — hue 297°, chroma 0.165. Two accent tones are generated per issue and each is proven against its own ground before it ships: a single accent that passes AA on both light and dark paper is arithmetically impossible.

Heading repairs

1 repair applied to the front matter so the document has one h1 and no skipped levels:

Shifted “10 headings” from h1 to h2 so the skill title is the only h1.

Spec compliance

Every skill satisfies the Agent Skills specification’s frontmatter rules.

Images

Images inside a skill come from the upstream repository. Where the author gave no alternative text we mark the image decorative rather than inventing a description — a plausible caption we made up is worse than none for the reader who depends on it.

Marketplace

A plugin manifest is published at .claude-plugin/marketplace.json by Mastra, declaring 1 plugin. It is read for editorial metadata only — never as the skill index, which is always the repository tree.

Signal

Install counts come from skills.sh. They measure downloads, not quality, and an unranked repository is not an unread one.

Agent surfaces

The whole issue is available as one markdown document at /mastra-ai/skills.md, and each skill at its own .md URL.

Publication

Set by Skills Docs from the source repository. Body text is Literata at the reader’s chosen size and measure; code is Geist Mono. Nothing on this page was written by us except this paragraph.

Contents