Mastra 推出 47 个 Agent Skills 开发者技能合集

Mastra 开发者的精选技能合集

面向 Mastra（TypeScript AI 框架）的逐功能 Agent Skills，用于构建、测试和交付 AI agent。

Mastra Skills 是 Mastra 框架的一套 47 个 Agent Skills。每个技能覆盖一个功能领域，例如 agents、tools、workflows、memory、RAG、evals 或部署。每个技能都会说明何时使用该功能、核心工作流、常见错误以及确切的 API，示例均取自当前 Mastra 文档。

路由技能 mastra-guide 会将任何请求发送到正确的技能，而 mastra-build-playbook 则引导项目从想法走向生产。

适用人群

使用 Mastra 以 TypeScript 构建 agent、工作流或 AI 后端的开发者

在 Mastra 项目上使用 AI 编码助手（Claude Code 及其他兼容 Agent Skills 的工具）的任何人

正在评估 Mastra、希望获得其功能结构化参考的团队

本仓库不适用于 Python 项目或其他框架。

解决的问题

过时或虚构的 API。助手常常根据旧的训练数据猜测 Mastra API。每个技能都会告诉助手先查阅当前文档。

快速变化的文档。Mastra 的文档规模庞大，且会在版本之间发生变化。技能会将每个功能映射到其来源的文档页面，因此更新易于追溯。

找到正确的功能。mastra-guide 中的路由表会将目标（例如“给我的 agent 一个数据库”）映射到覆盖该目标的技能。

重复的设置错误。常见错误（ESM 设置、模型字符串格式、工具签名、环境变量）都在一处集中说明。

只加载所需内容。每个功能一个技能，意味着助手只加载相关说明，而不是一整份大文档。

目录

本项目是什么

谁应该使用它

它解决了哪些问题

目录

安装

贡献

技能是如何构建的

目录

仓库结构

致谢

许可证

安装

选择以下方法之一。

/plugin marketplace add YGhorbel/awesome-mastra-skills /plugin install mastra-skills@mastra-skills

任何支持 skills CLI 的 agent

npx skills add YGhorbel/awesome-mastra-skills

手动安装

git clone https://github.com/YGhorbel/awesome-mastra-skills.git

然后将 skills/* 复制或符号链接到 ~/.claude/skills/（或你的 agent 的 skills 文件夹）。技能按需加载，因此在需要之前，上下文中只保留每个技能的名称和描述。

与官方 Mastra 技能的关系

Mastra 在 mastra-ai/skills（npx skills add mastra-ai/skills）发布了官方技能。它是一个宽泛的技能，涵盖当前文档查询、mastra api CLI 和 Mastra Factory。本仓库将 Mastra 拆分为按功能聚焦的多个技能。两者可以很好地配合使用。

贡献

欢迎贡献，尤其是针对过时 API 的修复、相互矛盾的文档以及更好的示例。

阅读 CONTRIBUTING.md 获取完整指南。简版如下：

python3 -m pip install pyyaml python3 scripts/validate_skills.py python3 scripts/generate_catalog.py --write

在 GitHub 上提交 issue 或 pull request。

技能是如何构建的

skills/mastra-<feature>/ SKILL.md 何时使用 / 何时不使用 / 必需输入 / 框架 / 工作流 / 失败模式 / 输出格式 / 参考文件 references/ api.md 确切的选项、签名、默认值 examples.md 完整、可运行的示例 checklist.md 构建和生产检查清单

查看 SKILL_AUTHORING.md 了解完整约定，查看 MAPPING.md 了解每个技能来自哪些 Mastra 文档页面。

目录

技能 涵盖内容

mastra-guide 路由器：将任何目标映射到正确的 Mastra 功能和技能，外加文档查询协议

mastra-project-setup create-mastra 和手动安装、tsconfig 和 ESM、src/mastra 布局、Mastra 类配置、env 文件、mastra dev 和 Studio

mastra-build-playbook 从想法到生产的 9 个阶段：范围、脚手架、第一个切片、上下文、安全、evals、追踪、集成、部署

mastra-troubleshooting 诊断流程和修复：ESM、tsconfig、模型字符串、环境变量、过时 API、工具、存储、记忆、客户端错误

mastra-migrations v1 升级指南、codemods、AI SDK v5、supervisor agents、MCP v2，以及 Mastra Cloud 到 Platform 的迁移

Agents

技能 涵盖内容

mastra-agents Agent 类、instructions、模型字符串、注册、generate 和 stream、动态配置、回退

mastra-tools createTool、schemas、execute 上下文、hooks、客户端工具、内置工具、代码模式，以及动态工具搜索

mastra-structured-output 使用 structuredOutput 的类型化 agent 输出、流式对象、结构化模型、提示注入和错误策略

mastra-processors-guardrails 输入、输出和错误处理器：内置护栏、自定义处理器、tripwires、重试和缓存

mastra-agent-approval-hitl 工具审批、暂停和恢复、自动恢复、listSuspendedRuns，以及通过 supervisor agents 进行审批

mastra-multi-agent Supervisor agents、子 agent、委托钩子、消息过滤、评分循环，以及 network() 迁移

mastra-agent-skills Mastra agent 的内联和文件系统技能：createSkill、工作区技能、动态技能集、getSkill 和 listSkills

mastra-file-based-agents 以目录形式存在的 agent：config.ts、instructions.md、tools/、skills/、subagents/、schedules/，以及优先级规则

mastra-classifier 使用决策模型进行类型化选择、评分和布尔决策，外加路由、护栏和模型选择

mastra-streaming Agent 和工作流流式传输：MastraModelOutput、chunk 类型、writer API、smoothStream、abort 和事件

mastra-voice Agent 语音：说、听、实时语音到语音、CompositeVoice、LiveKit，以及所有语音提供商

模型

技能 涵盖内容

mastra-models 模型路由字符串、提供商和环境变量、网关、自定义网关、回退、提供商选项、嵌入

工作流

技能 涵盖内容

mastra-workflows createWorkflow 和 createStep、控制流、作为步骤的 agent 和工具、状态、重试、动态工作流、运行和流式传输

mastra-workflow-suspend-resume 暂停和恢复、人在回路步骤、快照、状态读取器、运行状态、重启和时间旅行

记忆、RAG 和存储

技能 涵盖内容

mastra-memory

（原文较长，此处译出前 6000 字，完整内容请点「打开原文」。）