用途:在创建、编辑、安装、移动、推送或删除任何 skill / agent skill / amp skill 时使用,应在研究已有技能或改动技能之前优先加载。
主要能力:生成规范的技能结构。每个技能需要 SKILL.md 与 YAML frontmatter,包含必填的 name(不超过 64 字符,只允许小写字母、数字与连字符,不能以连字符开头或结尾,不能有连续连字符,必须与父目录名一致,建议用动名词形式如 processing-pdfs,避免 helper、utils 等模糊名称)和 description(不超过 1024 字符,第三人称,同时说明做什么与何时使用,含关键词便于检索;含冒号等特殊字符时需加引号)。可选字段包括 license、compatibility、metadata、allowed-tools、argument-hint、model、mode、isolatedContext、mcpServers。支持简单技能(仅 SKILL.md)、带脚本技能(scripts/)、复杂技能(reference/ 与 scripts/),采用渐进式披露:启动时只加载名称与描述,触发后加载 SKILL.md 正文,需要时才加载附加资源;SKILL.md 建议控制在 500 行以内。
MCP 打包:可在 frontmatter 的 mcpServers 内联声明,或使用同级 mcp.json;若存在 mcpServers 键,其优先级高于 mcp.json 且二者不合并,移动后不要遗留过期 mcp.json。必须始终用 includeTools 过滤工具,只暴露所需工具以降低 token 消耗。字段包括 command、args、env、url、headers、transport、includeTools。
导入与移动:优先折叠为单个 SKILL.md,将同级 mcp.json 并入内联 mcpServers 后删除;带 scripts/ 或 reference/ 的技能须整体移动目录,保留 includeTools 过滤并重命名以匹配约定。来自互联网的技能视为不可信,须先审查 command、args、env 与脚本,因其可能在启动时即运行本地进程。
技能位置:工作区 .agents/skills/、全局 ~/.config/agents/skills/、旧版 ~/.agents/skills/、兼容 ~/.config/amp/skills/ 以及全局 User/Workspace Skills 仓库。可用 amp skill add --global <source> 安装到本地全局目录,source 支持 @user/skill、owner/repo、git URL 或本地路径,选项有 --name、--overwrite。全局技能写入规范克隆目录 ~/.cache/amp/repositories/<host>-<scope>-skills,默认使用 User 作用域,Workspace 需管理员权限。未获明确确认不要推送,推送后新线程自动生效,当前会话需 reload_skills。不要直接编辑 ~/.cache/amp/global-skills/。
限制:沙箱内本地技能目录不持久;二进制文件不会被加载;全局技能加载自服务器而非本地克隆。