skill-authoring-sync

Installation
SKILL.md

Skill Authoring Sync

本技能把“中央仓库沉淀”和“项目侧安装”串成一次闭环。默认中央仓库是 https://github.com/why8023/agent-skills.git,默认安装方式是 npx skills 的 Project scope,不额外加 -g。

Workflow

先识别目标环境的管理方式

  • 用户要求刷新个人用户级安装时,先检查用户目录下 .apm/agent-config.json。读取其 repository 和 entrypoint,再检查登记仓库的 apm.yml 是否包含目标 Skill 的源路径。
  • 如果命中个人 APM 清单,完成下面的源码编写、验证、独立提交和推送后,调用登记仓库的 manage.ps1(Windows)或 manage.sh(Linux),执行 update --source <owner/repo/skill-subdirectory> 和 check;随后单独提交、推送个人清单更新。这条路径替代后面的 npx 安装步骤,目标 Agent 以个人清单为准。
  • 登记入口失效或 APM 更新失败时报告问题,不自动回退到 npx。个人机器路径、登录信息及私有清单不得写入中央 Skill 仓库。
  • 用户明确要求项目级安装时,先检查目标项目的 apm.yml。如果该项目已用 APM 管理此来源,使用其既有 APM 更新流程;没有采用 APM 的项目继续以下 npx 项目级流程,不因此扩大为全局安装。
  • 新增或重命名的 Skill 必须先加入目标清单并处理旧路径,再安装;不能仅因清单没有条目就绕过已有管理器。

编写与发布

Installs
5
First Seen
Mar 30, 2026