用途：编写或更新 Agent Skill，并解决技能改动难以生效的问题。
主要能力：说明技能目录结构——根目录 SKILL.md 含 YAML frontmatter 与 Markdown 指令，references/ 放按需读取内容，scripts/ 放脚本。frontmatter 仅六个键：name、description、license、compatibility（最多500字符环境要求）、metadata（字符串到字符串映射）、实验性 allowed-tools。附带脚本 scripts/names.py 可读取技能目录并查询公开搜索端点。
必要用法：安装与部署命令保持原样：npx skills add <owner>/<repo> --global --skill <name>（单个技能）、npx skills add <owner>/<repo> --global（整个仓库）；查看用 skills ls -g --json；移除用 skills remove -g --skill <old-name> -y。改名或删除后需手动移除旧名，因为安装是累加的。
关键限制：~/.agents/skills/ 下的副本不是源，仅是安装时的普通拷贝，编辑它会被下次安装覆盖。每次改动都应先找到源仓库，在所属仓库内做小量增量编辑，跑质量门，提交后再推送——安装器从远程克隆，未推送的提交对安装不可见。安装默认取远程默认分支，特性分支推送后安装仍无变化，需先合并或用本地路径迭代：skills add ../my-skills --skill <name>。-g/--global 不是默认值，省略时作用域随当前目录变化，会静默写入当前工作树。安装后需验证（skills ls 及运行 scripts/ 中命令），因为列出的技能不代表文件已到位；Claude Code 读取 .claude/skills 而非 .agents/skills，缺失时可 ln -s ~/.agents/skills ~/.claude/skills，并在 Claude Code 中用 /reload-skills。命名是主键：重名会被静默丢弃，名字归一化后大小写、下划线、连字符视为同一标识，改名是破坏性变更。用 python3 <path>/names.py check <candidate> 检查，退出码 0 干净、1 冲突、3 不确定。无强制命名风格约定，应把精力放在 description。
适用场景与限制：适用于编写技能、编辑 SKILL.md、发布技能仓库、把改动部署到本机。官方文本与收费、价格信息暂未提供。