用途:在当前调用工作目录中创建新的 agent skill,源码放在 <scope>/.agents/skills/<name>/,并在 <scope>/.claude/skills/<name> 建立相对符号链接,供 Claude Code 发现。仅支持调用时的工作目录作为作用域,拒绝 --global、显式目标路径等覆盖,也不得写入 ~/.agents、~/.claude、~/.codex 等全局目录。
主要能力:按渐进式披露组织技能内容,SKILL.md 只保留工作流,确定性逻辑放入 scripts/,长文档放入 references/,输出模板放入 assets/。要求 agents/openai.yaml 中 policy.allow_implicit_invocation 与 SKILL.md 的 disable-model-invocation 相反。
使用方式:参数 skill-name 必填且为 kebab-case。先获取 https://agentskills.io 最新规范,校验名称与路径冲突,再创建目录并写入 SKILL.md、agents/openai.yaml,最后建立符号链接并验证文件存在、链接指向正确、脚本可执行。
限制:SKILL.md 建议少于 500 行;引用文件只允许一层深度;不添加 README、CHANGELOG 等运行时无用文件;脚本优先用 bun run 运行 TypeScript,Python 用 uv run;Bash 脚本需兼容 Bash 3.2。具体 frontmatter 字段与最新规范以官方文档为准。