用途:在创建技能仓库、统一或校验技能仓库结构、搭建 Composer 与发布工作流、配置拆分许可时使用。
主要能力:给出标准仓库布局(plugin.json、.claude-plugin/plugin.json、skills/{name}/SKILL.md、README.md、LICENSE-MIT、LICENSE-CC-BY-SA-4.0、composer.json、references/、scripts/、.github/workflows/);定义拆分许可模型:skills//*.md、references/、README.md、docs/** 用 CC-BY-SA-4.0,scripts/**、工作流、.sh/.py/.php 及配置文件用 MIT,SPDX 为 (MIT AND CC-BY-SA-4.0),不使用单一 LICENSE 文件;规定 SKILL.md 前置元数据与预算(name ≤64 且与目录一致,description ≤1024、超 500 警告,正文 ≤500 行、超 300 警告);说明扁平发现规则(references 仅一层,SKILL.md 需列出每个 references/.md 与 scripts/ 可执行文件);根 plugin.json 为唯一事实来源,由 sync-plugin-manifest.sh 生成 .claude-plugin/plugin.json;composer.json 名称须与 GitHub 仓库一致、type 为 ai-agent-skill、无 version 字段与 composer.lock。
使用方式:技能仓库须将 CI 委托给可复用工作流,例如 .github/workflows/validate.yml 中 uses: netresearch/skill-repo-skill/.github/workflows/validate.yml@main;发布流程为更新根 plugin.json → 同步 → PR → 合并 → 拉取 main → 校验一致性 → 签名标签 → 推送 → 监控 Release,标签须在版本更新 PR 合并后创建。校验用 scripts/validate-skill.sh。安装方式包括 Marketplace、Release 下载、Composer、npm。
适用场景与限制:适用于技能仓库的创建、结构标准化、许可与发布管理。多仓库(>3)发布需先 dry-run 并审批;0.x 到 1.0.0 走 STABILIZE 流程;不得直接编辑已安装路径。具体命令细节与 npm 默认文件见 installation-methods,资料未提供完整命令内容。