skill-authoring-sync
Installation
SKILL.md
Skill Authoring Sync
本技能把“中央仓库沉淀”和“项目侧安装”串成一次闭环。默认中央仓库是 https://github.com/why8023/agent-skills.git,默认安装方式是 npx skills 的 Project scope,不额外加 -g。
Workflow
-
建立范围。
- 确认目标 skill 名称,统一使用小写加连字符。
- 判断这次是新增、更新还是重命名;重命名按“新增新目录 + 清理旧目录 + 更新安装”的方式处理。
- 确认目标业务项目根目录。如果用户没有给出项目路径且当前目录也不是目标项目,不要猜测目录;先完成中央仓库侧工作,再在安装前只补问一次项目路径。
- 默认中央仓库来源使用
git remote get-url origin。如果它不是why8023/agent-skills,或用户明确指定了其他来源,再按用户要求处理。
-
在中央仓库中定位或创建 skill。
- 只在中央仓库的
skills/<skill-name>/下工作。 - 新增 skill 时,优先在中央仓库的
skills/目录下运行npx skills init <skill-name>生成基础骨架;如果 CLI 只生成了SKILL.md,再按当前仓库约定补齐agents/openai.yaml。 - 新增 skill 时,至少交付
SKILL.md和agents/openai.yaml。 scripts/、references/、examples/、assets/只在确有复用价值时再创建;不要为了凑结构创建空目录。SKILL.md的 YAML frontmatter 只保留name和description;name必须与目录名完全一致。description里直接写清“做什么”和“什么时候触发”,把典型用户说法也压进去,不要把触发条件只写在正文里。
- 只在中央仓库的