技能（Skills）正在成为编码 Agent 的标配：把一段可复用的指令、脚本与资源打包成 SKILL.md，Claude Code、Codex、Cursor 等工具就能在相关任务里自动加载。麻烦也在这——技能分散在 GitHub、本地目录和各类合集仓库里，安装、更新、卸载全靠手动复制，装多了根本记不清版本。2026 年 8 月发布的 agent-skill（crates.io 上的 Rust 库 + CLI）把这件事收敛成一条命令。
先弄清 SKILL.md 装在哪里
SKILL.md 是一份带 frontmatter 的 Markdown：name 与 description 决定 Agent 什么时候加载它，正文是具体的操作步骤、脚本与资源。每个 Agent 有自己约定的技能目录，手动维护多个目录很容易漏装或装错版本。agent-skill 的解决方式是把技能统一装到 .agents/skills/（项目级）或 ~/.agents/skills/（全局），再自动挂到各 Agent 自己的技能目录。
第一步：安装 CLI
# 需要 Rust 工具链（rustup 安装）
cargo install agent-skill
# 验证
agent-skill --help第二步：安装技能包
# 安装仓库里的全部技能（默认装到当前项目）
agent-skill add anthropics/skills
# 只装某个技能，且只给 claude-code
agent-skill add anthropics/skills@pdf --agent claude-code
# 先看仓库里有什么技能，不实际安装
agent-skill add anthropics/skills --list来源不限于 GitHub：本地路径、GitLab、SSH/git URL，以及任意 HTTPS 端点（含 zip/tar.gz 和裸 SKILL.md）都支持。想装给所有 Agent 用 --agent '*'，跳过确认加 -y。
第三步：项目级与全局级
项目作用域把技能装进 ./.agents/skills/，全局作用域装进 ~/.agents/skills/，再用符号链接挂到各 Agent 的技能目录（Windows 上用目录链接，需要开发者模式或相应权限）。
# 全局安装（所有项目可用）
agent-skill add anthropics/skills --global
# 想复制而不是符号链接
agent-skill add anthropics/skills --copy第四步：列出、更新、卸载
# 列出已装技能（JSON 输出方便脚本处理）
agent-skill list --json
# 按锁文件更新到最新
agent-skill update
# 卸载某个技能
agent-skill remove pdf --agent claude-code每次安装会写 skills-lock.json，记录技能来源与内容 SHA-256 哈希，update 按锁文件做可复现更新——这正是把技能当作「依赖」来管理的做法。
什么时候值得用
- 技能数量超过 10 个，手工复制容易漏版本、装错目录
- 团队要在 CI 或新机器上统一安装一套技能
- 想在自己写的工具（插件管理器、Agent 启动器、构建脚本）里嵌入技能管理——agent-skill 本身是库优先设计，Rust 项目直接依赖即可
技能管理从「复制粘贴文件夹」变成「一条命令 + 一份锁文件」，走的还是包管理器那条老路。