Skill Authoring Sync

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

Workflow

1. 建立范围。

   • 确认目标 skill 名称，统一使用小写加连字符。
   • 判断这次是新增、更新还是重命名；重命名按“新增新目录 + 清理旧目录 + 更新安装”的方式处理。
   • 确认目标业务项目根目录。如果用户没有给出项目路径且当前目录也不是目标项目，不要猜测目录；先完成中央仓库侧工作，再在安装前只补问一次项目路径。
   • 默认中央仓库来源使用 git remote get-url origin。如果它不是 why8023/agent-skills，或用户明确指定了其他来源，再按用户要求处理。

2. 在中央仓库中定位或创建 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 里直接写清“做什么”和“什么时候触发”，把典型用户说法也压进去，不要把触发条件只写在正文里。