agents-skills 0.7.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 --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 的逆操作）
  • -g/--global 切换作用域：默认项目级 ./.agents/skills，加 -g 为全局 ~/.agents/skills。
  • agent --status 对未链接的 agent，若其自身目录已含技能，会列出这些技能名， 提示可用 --link --migrate 迁移；已链接/规范目录的 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 a, i, install 从来源安装技能包
remove rm, r 移除已安装技能
list ls 列出已安装技能
update upgrade, check 将技能更新到最新版本
disable d 禁用已安装技能
enable e 重新启用已禁用的技能
agent 链接/解除链接/查看 agent 链接状态

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

License

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

由你选择。