用途
add-skill 用于协调向 agent-skills 仓库添加一个新的外部技能，覆盖脚手架搭建、发布工作流注册以及符号链接创建三个环节。
何时使用
- 向 skills/ 添加新的 SDK/框架集成技能时
- 向 skills/ 添加新的 CLI 工具包装技能时
- 任何需要创建并注册 skills/<skill-name>/ 目录的场景
决策点
首先需要确认：这是集成型技能（智能体生成代码并测试调用真实 API），还是工具型技能（智能体运行 CLI 命令）？
- 集成型 → 调用 create-seed-skill，然后继续执行步骤 2–4
- 工具型 → 从步骤 1 开始手动搭建
集成型技能工作流
集成型技能包装 SDK 或框架，智能体生成可运行代码和集成测试。示例：ydc-ai-sdk-integration、teams-anthropic-integration、ydc-openai-agent-sdk-integration。
步骤 1（集成型）——调用 create-seed-skill。该技能负责：收集技能信息（名称、包、语言——TypeScript、Python 或两者、路径 A/B、环境变量、测试查询）；生成 skills/<skill-name>/SKILL.md 和 assets/；创建 tests/<skill-name>/ 目录及 .gitkeep 文件（若两种语言则各一个）；按语言向 data/prompts/prompts.jsonl 追加一条 prompts.jsonl 条目。需完整完成 create-seed-skill 工作流后再进入步骤 2。
工具型技能工作流
工具型技能是 CLI 包装器，智能体运行命令而非编写代码。示例：youdotcom-cli。
步骤 1——搭建技能目录。在 skills/<skill-name>/SKILL.md 创建技能目录和 SKILL.md。所需 frontmatter 包含 name、description、license、compatibility、metadata（author、version、category、keywords）。随后立即校验：
bunx @plaited/development-skills validate-skill skills/<skill-name>
步骤 2——在 publish.yml 中注册。对 .github/workflows/publish.yml 做两处编辑。
2a——添加输入。在 on.workflow_dispatch.inputs 下添加以技能名为键的输入项，包含 description、required: false、type: choice、default: skip，以及 skip/patch/minor/major 选项。
2b——添加任务。在 jobs: 部分末尾追加新任务，新任务必须 needs 当前最后一个任务以保持推送串行化。任务使用 ./.github/workflows/_publish.yml，传入 skill_name 和 bump_type，并设置 PUBLISH_TOKEN 密钥。需在运行时查找当前最后一个任务，不要依赖硬编码列表，可运行：
grep '^ publish-' .github/workflows/publish.yml | tail -1
输出形如 publish-youdotcom-cli:，取任务 ID（去掉末尾冒号）作为 needs 值。if: 中的 always() 是必需的——否则被跳过的前置任务会导致依赖任务也被跳过，即使本技能已被选中。
步骤 3——创建符号链接。外部技能从 .claude/skills/ 符号链接到 skills/：
ln -s ../../skills/<skill-name> .claude/skills/<skill-name>
注意：内部技能（位于 .agents/skills/）使用不同目标 ../../.agents/skills/<skill-name>，但本技能只处理外部技能。
步骤 4——最终校验。再次运行 validate-skill，确认输出报告 valid: true 后再提交。
相关技能
- create-seed-skill——集成型技能的完整脚手架工作流（SKILL.md + assets + prompts.jsonl）
- validate-skill——依据 AgentSkills 规范校验任意技能的结构
限制
本技能仅处理外部技能，不处理 .agents/skills/ 下的内部技能。