Melech Sync Skills 是面向 AdirD/agent-shell-hamelech 仓库的元技能，用于把该技能库全局同步到受支持的编码智能体。它使用 Vercel 的 Skills CLI（vercel-labs/skills）进行管理，自身不附带脚本，实际安装与刷新由 CLI 执行。
用途 该技能的核心用途是保持 Melech 技能库在各编码代理中的全局版本处于最新状态。用户通过自然语言触发，例如“melech-sync-skills”“sync melech skills”“melech sync”“keep skills up to date”表示执行同步；提到“melech-sync-skills list”“melech list”“melech status”时只做干目录（dry catalog）查询，不执行安装。
主要能力与使用方式 执行同步时，应运行一条命令，并且从用户主目录运行，以避免 CLI 自动切换到项目范围： cd ~ && npx skills add AdirD/agent-shell-hamelech --all -g --all 会展开为 --skill '' --agent '' -y，限定到指定仓库。它会安装新技能、刷新已有技能，且无需确认，不会触碰其他来源的全局技能。该过程大约需要 30 秒，因为它会刷新每一个技能，而不是只更新过期的技能。若本机缺少 npm，应停止并提示用户安装 Node.js。
查看干目录时使用： cd ~ && npx skills add AdirD/agent-shell-hamelech -l 查看已全局安装的技能使用： cd ~ && npx skills list -g 可通过 --json 获得机器可读输出。将两者按名称对比，可回答“还缺什么”。不存在远程与锁之间的版本比较——锁存储的是技能文件夹的 git tree SHA，而不是语义化版本，重新运行 apply 比计算差异更省事。
输出解读 输出中有两类看似失败但实际并非失败的情况：每个技能上出现 ✗ <skill> → Eve 和 ✗ <skill> → PromptScript。这两个代理完全不支持全局安装。命令仍会以 0 退出并打印 Done!，不应将其报告为同步失败。此外，输出中不会出现 ~/.cursor/skills 或 ~/.codex/skills 条目。Cursor、Codex、Amp、Zed、Warp、OpenCode 等在 CLI 注册表中属于通用代理，它们直接读取 ~/.agents/skills，因此全局安装会写入规范目录并跳过逐代理符号链接。拥有自己目录的代理（Claude Code、Droid、Continue、Goose、Roo 等约 40 个）会获得真实符号链接。新安装的技能不会出现在已打开的 Cursor 会话中——技能列表在会话开始时被快照，此时应让用户打开新会话，而不是重新运行同步。任何内容都不会被自动卸载；从远程删除的技能仍保持安装并保留其锁条目，直到按名称移除：npx skills remove <name> -g -y。
硬性规则 仅限全局：每次调用都传 -g。若不传，CLI 会在当前目录为项目时自动检测并选择项目范围，写入仓库锁。主目录 cwd：从 ~ 运行，绝不从仓库检出目录运行。指定仓库名：绝不运行裸的 npx skills update -g 或 npx skills check——两者会改动其他来源的无关全局技能；在 add --all 中指定仓库名才能保持仅针对 melech。绝不在仓库内运行不带 -g 的 npx skills list：某个注册表代理（OpenClaw）声明了裸 skills 目录，因此项目范围的 list 会把该仓库自身的创作文件夹报告为安装项，看起来像同步进了仓库，实际上并没有。所有代理：--all 已覆盖这一点，除非用户指定某个代理，否则不要缩小范围。
适用场景与限制 该技能适用于需要将 Melech 技能库统一同步到多个编码代理的用户，尤其是当技能库有更新、需要刷新全局安装时。其限制包括：Eve 和 PromptScript 不支持全局安装；已打开的 Cursor 会话不会实时看到新技能；不会自动卸载远程已删除的技能；没有仅更新变更项的廉价模式；需要 Node.js/npm 环境。旧技能名称为 melech 和 sync-melech-skills，本技能名为 melech-sync-skills；若全局锁中仍存在旧名称，应在本技能安装后移除：npx skills remove melech -g -y 和/或 npx skills remove sync-melech-skills -g -y。