mcpField
D
distribute-skill-to-all-agents

distribute-skill-to-all-agents

github.com/davidondrejAgent 工作流4.2k208 次安装今天更新
代码仓库

关于 distribute-skill-to-all-agents

用于在 Mac 上将全局技能分发到 Codex/OpenAI Agents、Claude Code、Pi Agent、Hermes Agent 和 Cursor。它列出标准路径、符号链接与复制步骤，并提供检查各处安装一致性的方法。

主要功能

  1. 01列出五种 Agent 的全局技能路径
  2. 02以 `~/.agents/skills/` 作为标准源
  3. 03配置符号链接并复制到 Hermes
  4. 04检查各路径下文件的字节数
  5. 05说明更新、冲突和移除方式

适用场景

  1. 01让多个 Agent 都能发现全局技能
  2. 02更新分散安装的技能副本
  3. 03排查副本不一致或路径错误

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davidondrej/skills --skill distribute-skill-to-all-agents

安装后在 Claude Code 中输入/distribute-skill-to-all-agents确认已加载。

详细介绍

在所有 Agent 之间分发技能

全局技能必须位于用户 Mac 上的全部五个位置，可直接存放或通过符号链接访问，这样每个 Agent 都能发现它。

技能位置

  • Codex / OpenAI Agents： ~/.agents/skills/ 是规范位置。请先在此处编写技能。
  • Claude Code： ~/.claude/skills/ → ~/.agents/skills/；已自动覆盖。
  • Pi Agent： ~/.pi/agent/skills/ → ~/.agents/skills/；已自动覆盖。必须使用嵌套的 /agent/，不能使用 ~/.pi/skills/。
  • Hermes Agent： ~/.hermes/skills/ 是独立副本；只需复制到 Hermes。
  • Cursor（IDE + CLI）： ~/.cursor/skills/ 是一个真实文件夹，不一定能可靠读取 ~/.agents/skills/。请为每项技能添加一个符号链接。切勿使用 ~/.cursor/skills-cursor/；其中存放的是 Cursor 内置技能。

工作流

  1. 在 ~/.agents/skills/<skill-name>/SKILL.md 中编写技能，遵循 effective-agent-skills。
  2. 验证 Claude 符号链接（一次性检查）： 
    ls -la ~/.claude/skills
# Expect: ~/.claude/skills -> ~/.agents/skills
    如果它是一个真实目录，则说明副本已不一致——操作前请先询问。
  3. 复制到 Hermes；Claude 和 Pi 已由符号链接覆盖： 
    SKILL=<skill-name>
cp -r ~/.agents/skills/$SKILL ~/.hermes/skills/
  4. 链接到 Cursor（如果已存在，则跳过）： 
    [ -e ~/.cursor/skills/$SKILL ] || ln -s ~/.agents/skills/$SKILL ~/.cursor/skills/$SKILL
    如果存在真实的 Cursor 副本且内容不同，请比较版本，并在替换前询问。
  5. 验证五个位置的字节数是否一致： 
    for p in ~/.agents/skills/$SKILL ~/.claude/skills/$SKILL ~/.pi/agent/skills/$SKILL ~/.hermes/skills/$SKILL ~/.cursor/skills/$SKILL; do
  echo "$p: $(wc -c < $p/SKILL.md) bytes"
done
    五个数字必须全部一致。如果 Claude、Pi 或 Cursor 的结果不同，请先检查符号链接再继续。

更新现有技能

从 ~/.agents/skills/ 重新复制到 ~/.hermes/skills/；Claude、Pi 和通过符号链接关联的 Cursor 技能会自动更新。默认情况下，cp -r 会覆盖文件。如果可能有嵌套文件已被删除，请使用 rsync -a --delete：

rsync -a --delete ~/.agents/skills/$SKILL/ ~/.hermes/skills/$SKILL/

注意事项

  • ~/.pi/skills/ 不是正确的全局位置。 Pi 从 ~/.pi/agent/skills/ 加载技能；前者中的技能不可见，或成为孤立文件。删除前请与用户确认。
  • 不要复制到 Claude 或 Pi 的符号链接中。 它们已指向 ~/.agents/skills/；复制到那里会报错，提示 "are identical"。只有 Hermes 是独立副本。除非用户提出要求，否则不要将其替换为符号链接。
  • 项目本地技能发生冲突时可以覆盖全局技能（后发现的优先），包括仓库中的 ./.pi/agent/skills/ 或 .pi/skills/。此工作流仅处理全局分发。
  • Hermes 和 Cursor 会在会话启动时加载技能。 要发现新分发的技能，请重启正在运行的会话。
  • 文件名大小写很重要（在区分大小写的卷上）：请使用大写的 SKILL.md。

何时不使用此技能

  • 项目专用技能： 使用仓库本地的 ./.claude/skills/、./.pi/agent/skills/ 等。
  • 仅编辑单个 Agent（例如仅编辑 Hermes）：直接修改对应文件，不要传播。
  • 全局移除： 请先与用户确认；删除操作不可逆。使用 rm -rf 从 ~/.agents/skills/（覆盖 Claude 和 Pi）、~/.hermes/skills/ 以及 ~/.cursor/skills/ 符号链接中移除。

评论

支持 Markdown