关于 melech-sync-skills
melech-sync-skills 通过 Vercel's Skills CLI 安装或刷新 AdirD/agent-shell-hamelech 中的全局技能。它也提供仅查看目录的方式,可检查远程和已安装技能而不执行安装。
主要功能
- 01安装或刷新指定仓库的全部技能
- 02从主目录以全局范围运行
- 03查看远程技能而不安装
- 04列出全局已安装技能
- 05将同步限制在指定仓库
适用场景
- 01刷新 Melech 全局技能集
- 02为所有 Agent 安装仓库技能
- 03查看远程技能目录
- 04检查全局已安装的技能
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ adird/ agent-shell-hamelech --skill melech-sync-skills安装后在 Claude Code 中输入/melech-sync-skills确认已加载。
详细介绍
同步 Melech 技能 — 全局库同步
你是
AdirD/agent-shell-hamelech 的元技能。
规范来源(shell 中有两个 l):
AdirD/agent-shell-hamelech
由 Vercel 的 Skills CLI
(vercel-labs/skills) 管理。此技能
不包含脚本——CLI 会完成工作,你只需正确运行它。
旧技能名称为 melech 和 sync-melech-skills。此技能名为
melech-sync-skills。如果全局锁文件中仍有任一旧名称,请在安装此技能后将其移除:npx skills remove melech -g -y 和/或
npx skills remove sync-melech-skills -g -y。
用户如何调用此技能
| 用户说 | 你要做什么 |
|---|---|
melech-sync-skills、sync melech skills、melech sync、保持技能为最新 | **执行。**运行下方的同步命令。 |
melech-sync-skills list、melech list、melech status | 仅试运行目录查询。不要安装。 |
执行
只需一条命令。从用户的主目录运行,避免 CLI 切换到项目范围:
cd ~ && npx skills add AdirD/agent-shell-hamelech --all -g
--all 会展开为 --skill '*' --agent '*' -y,并限定在指定仓库范围内。
它会安装新技能、更新现有技能,且无需确认。它不会影响来自其他来源的全局技能。
大约需要 30 秒——它会更新每个技能,而不只是过时的技能。 没有值得维护的、更省事的“仅更新有变更项”模式。
如果缺少 npm,请停止并告知用户安装 Node.js。
阅读输出
有两种情况看起来像失败,但实际并非如此:
- 每个技能都出现
✗ <skill> → Eve和✗ <skill> → PromptScript。这两个 Agent 根本不支持全局安装。命令仍会以 0 退出并打印Done!。切勿将这些报告为同步失败。 - 输出中没有
~/.cursor/skills或~/.codex/skills条目。Cursor、Codex、Amp、Zed、Warp、OpenCode 等在 CLI 注册表中属于通用 Agent:它们会直接读取~/.agents/skills,因此全局安装会写入规范目录,并跳过各 Agent 的符号链接。有自己目录的 Agent(Claude Code、Droid、Continue、Goose、Roo 等约 40 个)则会获得真正的符号链接。
新安装的技能不会显示在已打开的 Cursor 会话中——技能列表会在会话开始时创建快照。请告知用户开启新会话,不要重新运行同步。
不会卸载任何内容。远程已删除的技能仍会保留在本地,其锁文件条目也会继续存在,直到按名称将其移除:
npx skills remove <name> -g -y。
试运行目录查询(melech-sync-skills list)
远程有哪些内容及其描述:
cd ~ && npx skills add AdirD/agent-shell-hamelech -l
已全局安装的内容(使用 --json 获取机器可读输出):
cd ~ && npx skills list -g
按名称比较两者,以回答“我缺少哪些内容”。无法比较远程版本与锁文件版本——锁文件保存的是技能文件夹的 Git 树 SHA,而不是 semver;重新运行执行命令比计算差异更省事。
硬性规则
- **仅限全局。**每次调用都必须传入
-g。不传时,CLI 会自动检测;只要当前工作目录是项目,就会选择项目范围并写入仓库锁文件。 - **工作目录必须是主目录。**从
~运行,绝不要在仓库检出目录中运行。 - **指定仓库名称。**绝不要直接运行
npx skills update -g或npx skills check——这两个命令都会修改来自其他来源的无关全局技能。在add --all中指定仓库,才能确保只处理 Melech。 - **绝不要在仓库内不带
-g运行npx skills list。**一个注册表 Agent(OpenClaw)声明了一个名为skills的目录,因此项目范围内的列表会把此仓库自身的创作文件夹报告为已安装内容。这看起来像是同步到了仓库里,其实没有。 - 涵盖所有 Agent。
--all已处理此项。除非用户指定某个 Agent,否则不要缩小范围。
语气
简洁有力。先给结论(已安装/已更新/确实失败),再列名称。同步成功后,不要倾倒目录内容,除非用户要求 list。不要复述 Eve 和 PromptScript 的噪声。