Back to Details

melech-sync-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Sync Melech Skills — global library sync

同步Melech技能 —— 全局库同步

You are the meta-skill for 
AdirD/agent-shell-hamelech
.
Canonical source (double 
l
in 
shell
):
text
AdirD/agent-shell-hamelech
Managed with Vercel's Skills CLI (
vercel-labs/skills
). This skill ships no scripts — the CLI does the work, you just run it correctly.
The old skill names were 
melech
and 
sync-melech-skills
. This skill is 
melech-sync-skills
. If the global lock still has either old name, remove it after this one is installed: 
npx skills remove melech -g -y
and/or 
npx skills remove sync-melech-skills -g -y
.
你是
AdirD/agent-shell-hamelech
的元技能。
标准源（注意
shell
里有两个
l
）：
text
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
。

How the user invokes this

用户调用方式

They sayYou do
melech-sync-skills
, 
sync melech skills
, 
melech sync
, keep skills up to date		Apply. Run the sync command below.
melech-sync-skills list
, 
melech list
, 
melech status
Dry catalog only. Do not install.
用户指令执行操作
melech-sync-skills
、
sync melech skills
、
melech sync
、keep skills up to date		执行同步。运行下方的同步命令。
melech-sync-skills list
、
melech list
、
melech status
仅查看目录预览。请勿执行安装操作。

Apply

执行同步

One command. Run it from the user's home so the CLI cannot flip to project scope:
bash
cd ~ && npx skills add AdirD/agent-shell-hamelech --all -g
--all
expands to 
--skill '*' --agent '*' -y
, scoped to the named repo. It installs new skills, refreshes existing ones, and needs no confirmation. It does not touch global skills from other sources.
Takes roughly 30 seconds — it refreshes every skill, not just stale ones. There is no cheaper "only what changed" mode worth maintaining.
If 
npm
is missing, stop and tell the user to install Node.js.
只需一条命令。请在用户的主目录下运行，避免CLI自动切换到项目范围：
bash
cd ~ && npx skills add AdirD/agent-shell-hamelech --all -g
--all
等价于
--skill '*' --agent '*' -y
，作用范围限定为指定仓库。它会安装新技能、刷新现有技能，且无需确认。此操作不会影响来自其他源的全局技能。
整个过程约需30秒——它会刷新所有技能，而非仅更新过期技能。目前没有值得维护的“仅变更内容”轻量化模式。
如果系统缺少
npm
，请停止操作并告知用户安装Node.js。

Reading the output

输出解读

Two things look like failures and are not:
  • ✗ <skill> → Eve
    and 
    ✗ <skill> → PromptScript
    on every skill. Those two agents do not support global installs at all. The command still exits 0 and prints 
    Done!
    . Never report these as a failed sync.
  • No 
    ~/.cursor/skills
    or 
    ~/.codex/skills
    entries appear. Cursor, Codex, Amp, Zed, Warp, OpenCode, and friends are universal agents in the CLI registry: they read 
    ~/.agents/skills
    directly, so a global install writes the canonical dir and skips the per-agent symlink. Agents with their own dir (Claude Code, Droid, Continue, Goose, Roo, ~40 more) get real symlinks.
A newly installed skill will not show up in an already-open Cursor session — the skill list is snapshotted at session start. Tell the user to open a new session, do not re-run the sync.
Nothing is ever uninstalled. A skill deleted from remote stays installed and keeps its lock entry until it is removed by name: 
npx skills remove <name> -g -y
.
以下两种情况看似失败，但实际并非如此：
  • 每个技能都会显示
    ✗ <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
。

Dry catalog (
melech-sync-skills list
)

目录预览（
melech-sync-skills list
）

What is on remote, with descriptions:
bash
cd ~ && npx skills add AdirD/agent-shell-hamelech -l
What is installed globally (
--json
for machine-readable):
bash
cd ~ && npx skills list -g
Diff the two by name to answer "what am I missing". There is no remote-versus-lock version comparison — the lock stores skill-folder git tree SHAs, not semver, and re-running apply is cheaper than computing the diff.
查看远程仓库中的技能及其描述：
bash
cd ~ && npx skills add AdirD/agent-shell-hamelech -l
查看已全局安装的技能（添加
--json
可获取机器可读格式）：
bash
cd ~ && npx skills list -g
通过名称对比两者，即可得知“我缺少哪些技能”。目前不支持远程版本与锁版本的对比——锁存储的是技能文件夹的git树SHA值，而非语义化版本，重新执行同步操作比计算差异更高效。

Hard rules

硬性规则

  1. Global only. Every call passes 
    -g
    . Without it the CLI auto-detects and picks project scope whenever the cwd is a project, writing a repo lock.
  2. Home cwd. Run from 
    ~
    , never from a repo checkout.
  3. Name the repo. Never run bare 
    npx skills update -g
    or 
    npx skills check
    — both mutate unrelated global skills from other sources. Naming the repo in 
    add --all
    is what keeps this melech-only.
  4. Never 
    npx skills list
    without 
    -g
    from inside a repo.     One registry agent (OpenClaw) declares a bare 
    skills
    directory, so a project-scope list reports this repo's own authoring folders as installs. It looks like the sync went into the repo. It did not.
  5. Every agent. 
    --all
    covers this. Do not narrow to one agent unless the user names one.
  1. 仅限全局范围。每次调用必须添加
    -g
    参数。如果没有该参数，当当前工作目录为项目目录时，CLI会自动检测并切换到项目范围，写入仓库锁文件。
  2. 主目录执行。必须在
    ~
    目录下运行，切勿在仓库检出目录中执行。
  3. 指定仓库名称。切勿运行无参数的
    npx skills update -g
    或
    npx skills check
    ——这两个命令会修改来自其他源的无关全局技能。在
    add --all
    中指定仓库名称，才能确保仅同步Melech相关技能。
  4. 仓库内执行
    npx skills list
    必须加
    -g
    。有一个注册表Agent（OpenClaw）会声明一个空的
    skills
    目录，因此项目范围的列表会将本仓库的作者目录显示为已安装技能，看起来像是同步到了仓库中，但实际并非如此。
  5. 覆盖所有Agent。
    --all
    参数已涵盖所有Agent。除非用户指定某个Agent，否则请勿缩小范围到单个Agent。

Voice

表述风格

Sharp and short. Verdict first (installed / refreshed / genuinely failed), then names. Do not dump the catalog after a clean sync unless they asked for 
list
. Do not recite the Eve and PromptScript noise.
简洁直接。先给出结论（已安装/已刷新/真正失败），再列出名称。同步完成后，除非用户要求
list
，否则不要输出完整目录。无需提及Eve和PromptScript的无关信息。