安装
npx skills add mastra-ai/skills适合谁
适合要用 Mastra 框架写 AI 应用或 agent,并让编程助手按官方技能来做的人。官方写明:这些是给使用 Mastra 框架的 agent 准备的正式技能。Mastra 是用现代 TypeScript 栈构建 AI 应用和 agent 的框架。框架站点:
https://mastra.ai/
更合适的人,是已经有 TypeScript / Mastra 项目,或正准备按官方综合技能开发的人。原文把收录内容写成“单一综合技能”,用渐进展开(progressive disclosure)和参考文件覆盖后续主题;本段没有列出那些参考文件名。
开始前要能运行 npx skills add。主路径不要改成未验证的其他安装器。
3 分钟完成第一次尝试
只走仓库给出的主安装命令。第一次做只读对照,不要先生成新的生产 agent。
前置条件:本机已有 npm/npx,并且手头有自己的 TypeScript 项目或即将初始化的 Mastra 代码。不要发明示例仓库地址。
安装位置:在工作区执行:
npx skills add mastra-ai/skills
官方仓库:
https://github.com/mastra-ai/skills
低风险触发:安装后,让助手按这套综合技能检查你已有的 Mastra 代码结构,只说明它会查阅哪些官方口径,先不要改文件。若助手开始创建新 agent 或写网络调用,先确认副作用。
成功信号:技能已添加,助手按“单一综合技能”讨论 Mastra 开发,且没有写入未确认的文件。若技能未出现,先核对安装命令是否完整,不要改用未点名的包名。
使用案例
案例一:在已有 TypeScript 项目里做 Mastra 开发检查。使用官方综合技能。适合已经有应用骨架、想按正式技能补齐 agent 能力的人。证据只说到渐进展开和参考文件,没有列出文件名。先检查,再决定是否改代码。
案例二:走 .well-known 发现。Mastra 也支持该发现标准,官方补充命令如下。
npx skills add https://mastra.ai/
仓库通过 RFC 8615 Well-Known URI 提供技能:
https://mastra.ai/.well-known/skills/
标准说明:
https://github.com/cloudflare/agent-skills-discovery-rfc
适合想从框架站点发现技能的人。这是第二条安装路径,不要和主命令在同一次操作里混用。证据没有写出发现后会装上哪些文件。
使用边界
主安装命令是 npx skills add mastra-ai/skills。.well-known 路径是补充,不是默认第一次尝试。
原文只描述“单一综合技能”,没有点名技能文件夹。不要补写 skills/ 路径或参考文件名。
这是 TypeScript 框架上的官方技能,没有给出其他语言的安装步骤,也没有给出助手互斥名单。
不要发明额外文档站以外的网址;框架站点与仓库页以外,只使用原文里的发现地址和 RFC 链接。