用途:在调用工作目录下创建项目本地技能,源目录为 <scope>/.agents/skills/<name>/,并在 <scope>/.claude/skills/<name> 建立指向 ../../.agents/skills/<name> 的相对符号链接。拒绝 --global、显式目标路径等作用域覆盖,不支持全局安装目录。
主要能力与流程:先应用仓库目录守卫,若仓库指令定义了技能来源目录与生命周期则停止本流程并遵循仓库自有流程;解析并校验本地作用域,源目录或链接路径已存在则停止;读取当前格式来源,运行 scripts/fetch-agentskills-spec.sh [--refresh] 并完整阅读返回文件,同时用 WebFetch 获取 Claude Code frontmatter 参考;阅读 references/writing-great-skills.md 后定义契约与布局;创建 SKILL.md 与 agents/openai.yaml,按需创建 scripts、references 等子目录;创建符号链接;最后验证并报告。
写作要求:面向当前 Claude 与 GPT 智能体模型写作,不在技能正文中指定模型、版本或模型专属默认值(选择、配置或归属模型的字段除外);基于官方厂商指南,复杂或编排型技能需先读两份指南;说明用户指令优先于技能;明确写作风格、进度更新与委派偏好;避免泛泛风格建议,指出具体要避免的模式;验证与改动成比例;不要求把推理写进回复文本。撰写或修改技能文本前需完整阅读 references/asd-ste100.md 并完成其含义与风格审查。
输入与限制:可选 skill-name 为 kebab-case 名称,省略时推导最短无歧义名称并在完成报告中说明;名称无效或与现有技能冲突时停止。SKILL.md frontmatter 按字母排序、description 置末,触发短语前置;依赖用 skill-dependencies 数组,同仓库用裸名,外部用 ORG/REPO#SKILL。agents/openai.yaml 中 policy.allow_implicit_invocation 取 SKILL.md disable-model-invocation 的反值。验证包括检查 SKILL.md 与 openai.yaml 存在、readlink 结果正确、scripts 与 tests 可执行,以及 ai-skillet doctor --root "<scope>/.agents/skills/<name>" 退出码为 0。
适用场景:为普通仓库添加项目本地、可被 Claude Code 发现的智能体技能。限制:不创建或修改 ~/.agents、~/.claude、~/.codex 等全局目录;不直接抓取 agentskills.io 规范或在仓库内创建其缓存;缓存不可用时可设 AGENTSKILLS_CACHE_DIR;若辅助脚本无法返回有效文件则在写入前停止。其他细节暂未提供。