skill-sync

Installation
SKILL.md

Skill Sync

在开始前,确认当前仓库是否以 skills/<skill-name>/ 组织 skill。默认交付物至少包含 SKILL.md;如果仓库已经使用 agents/openai.yaml,也一并创建或更新。

Default Sync Targets

  • 默认附加 agent 目标:codexclaude-codeopenclawcursoropencodeqodertraetrae-cnwindsurf
  • Universalnpx skills 自动包含,对应 .agents/skills;默认不要额外写 -a universal
  • 如果用户明确要求只更新其中一部分 agent,就把默认目标集缩小到用户指定范围。
  • 统一约定:只有在“全部 skill + 全部受支持 agent”都要同步时才使用 --all
  • 不要再使用 --skill '*';当前 Windows 环境下它可能不会按“全部 skill”解析。

Workflow

  1. 建立变更范围。
    • 确认目标 skill 名,使用小写加连字符。
    • 检查 skills/ 下是否重名;更新已有 skill 时复用原目录。
    • 如果是重命名 skill,明确旧名和新名,并把这次工作视为“新增新 skill + 删除旧 skill + 清理旧安装”。
    • 只处理本次目标 skill 相关文件,不要混入仓库里其他未完成变更。
Related skills

More from why8023/agent-skills

Installs
2
First Seen
Apr 13, 2026