Skill开发

• 怎么设计 Skill？如何封装 Skill？别人如何调用你封装的 Skill
• 封装skill需要遵循什么？ 需要一定有package.json吗，相关目录规范有一定约束吗？
  • 核心是SKILL.md，这个是agent技能的说明书，具体是否需要package，得看这个skill是否有用到相关的npm包

开发skill步骤：

• 一个 npm 包 / Node 项目
• 有标准的 skill 入口文件
• 有配置文件（如 skill.json 或 package.json 中的 skills 字段）
• 暴露特定能力（命令、API、工具等）

skill目录规范约束 SKILL.md

• skill 的硬性核心只有 SKILL.md，其它目录和 package.json 都是“按需”
• SKILL.md 就是 这个 skill 的“说明书 + 触发规则”文件
• SKILL.md 负责告诉 agent 何时用、怎么执行
  • 在SKILL.md里面说明哪些目录，告诉agent在哪里目录下执行脚本
  • SKILL.md可以告诉agent执行相关脚本，比如node脚本、python脚本等等
• SKILL.md必须是合法 YAML frontmatter，最少包含name和description
  • name 建议小写+连字符，保持唯一、稳定
• 技能安装本质是 skills add 把文件链接/复制到 agent 的 skills 目录，不是 npm 包安装流程
• SKILL.md 内容可以是中文

本地验证skill

• 本地 通过node来跑相关脚本，验证脚本是否有报错、是否通过

发布到github

bash

# 使用 GitHub 简写 (用户名/仓库名)
npx skills add your-username/your-skill-repo

# 或者使用完整的 HTTPS 地址
npx skills add https://github.com/your-username/your-skill-repo

发布到npm