mastra-agent-skills
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/mastra-ai/skills with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/mastra-ai/skills'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/mastra-ai--skills)HTML
<a href="/listings/mastra-ai--skills"><img src="/api/listings/mastra-ai--skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx skills add mastra-ai/skills
Mastra also supports the [`.well-known` skills discovery standard](https://github.com/cloudflare/agent-skills-discovery-rfc):
npx skills add https://mastra.ai/
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 19 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "mastra-agent-skills",
- "owner": {
- "name": "Mastra",
- "email": "team@mastra.ai"
- },
- "metadata": {
- "version": "1.0.0"
- },
- "plugins": [
- {
- "name": "mastra-skills",
- "description": "Mastra framework and Factory operations skills with progressive disclosure for development, API inspection, troubleshooting, and operations.",
- "skills": ["./skills/mastra", "./skills/mastra-factory"],
- "source": "./",
- "strict": false
- }
- ]
- }
README.md · README · 90 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Mastra Agent Skills
- Official Mastra skills for agents working with the [Mastra framework](https://mastra.ai). Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.
- ## Installation
- ```bash
- npx skills add mastra-ai/skills
- ```
- Mastra also supports the [`.well-known` skills discovery standard](https://github.com/cloudflare/agent-skills-discovery-rfc):
- ```bash
- 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
- - **Mastra Platform** (`references/platform.md`): Build and deploy apps to Mastra Platform with Platform APIs, `mastra deploy`, and Platform workspaces
- - **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.
- ### mastra-factory
- Standalone Factory 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](skills/mastra-factory/references/connection.md): connect to your own deployment without a repository or project link file; choose the correct agent and installation scope.
- - [Session and memory inspection](skills/mastra-factory/references/session-inspection.md): find your work, inspect progress and OM evidence, and distinguish attention items from repair authorization.
- - [Factory CLI commands](skills/mastra-factory/references/factory-cli.md): contracts, output control, and safe mutations.
- Install just the Factory skill with interactive agent/scope selection:
- ```bash
- 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
- ```bash
- 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](https://github.com/cloudflare/agent-skills-discovery-rfc) 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!
- 1. Fork the repository
- 2. Make improvements to `SKILL.md` files
- 3. Test with actual development workflows
- 4. Submit a pull request
- ## Resources
- - [Mastra Docs](https://mastra.ai/docs)
- - [Mastra GitHub](https://github.com/mastra-ai/mastra)
- - [Agent Skills Spec](https://agentskills.io)
- - [`.well-known` Skills RFC](https://github.com/cloudflare/agent-skills-discovery-rfc)
- - [Discord](https://discord.gg/BTYqqHKUrf)
- ## License
- Apache-2.0 - See [LICENSE](LICENSE) for details
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.