用途:在当前调用时的工作目录中脚手架式创建一个新的 agent skill,源码位于 <scope>/.agents/skills/<name>/,并在 <scope>/.claude/skills/<name> 建立指向 ../../.agents/skills/<name> 的相对符号链接,供 Claude Code 发现。
主要能力与结构:必需参数为 kebab-case 的 skill 名称(如 my-skill),缺失或非法即停止;拒绝 --global、显式目标路径等作用域覆盖,仅支持调用时的工作目录作用域,不写入 ~/.agents、~/.claude、~/.codex 等全局目录。标准布局:必需的 SKILL.md(frontmatter + 精简工作流,目标 500 行以内)与 agents/openai.yaml(Codex 元数据,禁用隐式调用);可选的 scripts/(确定性逻辑)、references/(按需加载的长文档)、assets/(写入输出的模板等,不进入上下文)。技能通过渐进式披露加载:发现阶段仅见名称与描述,激活阶段读取 SKILL.md 正文,执行阶段脚本无需读入上下文。
必要用法:mkdir -p "<scope>/.agents/skills/<name>/agents";写 SKILL.md 与 agents/openai.yaml(policy.allow_implicit_invocation 取 SKILL.md 中 disable-model-invocation 的反值);创建链接:mkdir -p "<scope>/.claude/skills" 与 ln -s "../../.agents/skills/<name>" "<scope>/.claude/skills/<name>"。验证前对 scripts/、tests/ 下可执行文件 chmod 755,并检查 SKILL.md、openai.yaml 存在、readlink 指向源码目录、脚本具备可执行权限。编写前应抓取 https://agentskills.io 最新规范,并阅读 references/writing-great-skills.md。脚本优先 TypeScript 经 bun run,Python 经 uv run,不直接使用 python/python3;技能内 Bash 脚本需兼容 Bash 3.2。
限制:不得重定向作用域到仓库根或全局目录;目标路径已存在则停止;内容不得写入 README、CHANGELOG 等运行时不用的文件;description 需前置触发词,路径均相对技能目录。关于收费、价格、平台与具体效果,资料暂未提供。