Claude-skill-registry alma-skill-sync

用于同步 Alma 技能到斜杠命令(Prompts)列表。当用户新增技能、修改技能名称或需要清理无效的快捷指令时使用。

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/alma-skill-sync" ~/.claude/skills/majiayu000-claude-skill-registry-alma-skill-sync && rm -rf "$T"
manifest: skills/data/alma-skill-sync/SKILL.md
source content

Alma Skill Sync

该技能负责将存储在

~/.claude/skills/
目录下的技能同步到 Alma 的斜杠命令(/)列表中,使用户可以通过输入
/技能名
快速调用。

使用场景

  1. 新增技能后:当你创建了新的技能,希望在输入框输入
    /
    就能看到它。
  2. 清理无效指令:当你删除了某些技能,希望对应的斜杠命令也一并消失。
  3. 状态检查:列出当前的同步状态。

工作流程

1. 同步技能 (Sync)

运行同步脚本,将所有现有的技能注册为 Alma 的 Prompts。

python3 /Users/douba/.claude/skills/alma-skill-sync/scripts/sync_to_alma.py

2. 清理模式 (Clean Sync)

运行同步脚本并开启清理模式,这会移除那些在技能目录中已不存在但仍在 Alma Prompt 列表中的快捷指令。

python3 /Users/douba/.claude/skills/alma-skill-sync/scripts/sync_to_alma.py --clean

注意事项

  • API 依赖:该技能依赖于 Alma 在
    localhost:23001
    提供的 REST API。
  • 匹配规则:快捷指令的名称将与技能
    SKILL.md
    中定义的
    name
    字段严格一致。
  • 触发机制:生成的快捷指令内容为
    @技能名
    ,这会利用 Alma 的原生语义引擎激活对应的技能。

资源说明

  • 脚本位置
    /Users/douba/.claude/skills/alma-skill-sync/scripts/sync_to_alma.py
  • 参考资料
    /Users/douba/.claude/skills/alma-skill-sync/references/api_reference.md
    包含了 Alma 的 API 规范。