agents-skills 0.9.0

A minimal, stable, easy-to-understand skill installer and manager for AI agents
Documentation

agents-skills

crates.io docs.rs CI License

一个极简的 AI Agent 技能安装与管理工具：所有技能集中存放在一个规范目录， 通过一次 agent --link 即可让 Claude Code、Codex、Cursor 等 70+ 编程 Agent 全部可见可用——安装一次，处处生效。

cargo install agents-skills

同时提供可嵌入的 Rust 库，见 docs/LIBRARY.md。

快速开始

agents-skills agent --link            # 链接所有已安装的 agent
agents-skills add anthropics/skills   # 安装技能包（装进规范目录后所有 agent 立即可见）
agents-skills list                    # 查看已安装技能
agents-skills agent --status          # 查看各 agent 的链接状态

核心是链接：技能只在规范目录保存一份（项目级 .agents/skills/ 或全局级 ~/.agents/skills/），agent --link 为每个已安装的 agent 在其技能目录创建指向 规范目录的符号链接；之后 add 安装的技能所有 agent 立即可见，无需同步。

功能说明

add/remove/update/disable/enable 只操作规范目录，agent 通过符号链接自动 共享。常用命令：

agents-skills agent --link claude-code            # 链接（存量内容自动备份）
agents-skills agent --link claude-code --migrate  # 链接并把存量技能迁入规范目录
agents-skills agent --unlink claude-code          # 解除链接（并恢复备份内容）
agents-skills add anthropics/skills@pdf            # 仅安装指定技能
agents-skills list --json                          # 机器可读输出
agents-skills remove pdf                           # 移除指定技能
agents-skills update                               # 按 lockfile 更新到最新版本
agents-skills disable pdf                          # 禁用（移出规范目录，文件保留）
agents-skills enable pdf                           # 重新启用（disable 的逆操作）
  • 默认操作全局作用域 ~/.agents/skills;--project <目录> 切换到项目级（在指定 目录的 .agents/skills 下，当前目录写 --project .）。
  • agent --link 遇到 agent 技能目录已有内容时不拒绝：整个目录原样移入备份槽 .agents/backup-skills/<agent>/skills/，agent --unlink 时整体恢复；加 --migrate 则把其中的技能移入规范目录（同名时以规范目录为准，agent 侧副本留在备份）。
  • agent --status 对未链接的 agent，分类列出其自身技能目录中的内容 （private skills / other files）以及待恢复的备份（backup parked at）； 已链接/规范目录的 agent 内容由 list 展示。
  • 已禁用的技能 update 会跳过；list 始终展示全部技能并标注 enabled/disabled。

来源格式

add 的 <source> 参数支持：

格式 示例
本地路径 ./my-skill, /abs/path/skill
GitHub 简写 owner/repo, owner/repo@skill, owner/repo/subpath
GitHub / GitLab URL https://github.com/owner/repo, https://gitlab.com/group/repo
SSH / git URL git@github.com:owner/repo.git
HTTPS（well-known） https://example.com/skills（发现 → 下载兜底）
HTTPS（下载） .../skill.zip, .../skill.tar.gz, 原始 SKILL.md

仓库内按优先级容器目录发现技能（skills/、.curated/、.experimental/、 .system/），浅层遮蔽深层。

安装位置

  • 规范目录（唯一真实副本） —— 项目级 ./.agents/skills/<name>，全局级 ~/.agents/skills/<name>。
  • Agent 集成 —— 不原生读取规范目录的 agent 获得目录级符号链接： .claude/skills → ../.agents/skills（项目）或 ~/.claude/skills → ~/.agents/skills（全局）。

命令速查表

命令 说明
add 从来源安装技能包
remove 移除已安装技能
list 列出已安装技能
update 将技能更新到最新版本
disable 禁用已安装技能
enable 重新启用已禁用的技能
agent 链接/解除链接/查看 agent 链接状态

命令不设别名（极简接口，只认全名）。

完整命令行参考见 docs/CLI.md；库使用者见 docs/LIBRARY.md；项目开发者见 docs/DEVELOPER.md。

License

在以下任一许可证下授权：

由你选择。