skill-repo

skill-repo 是专为简化 AI Agent 技能生命周期而设计的综合工具组。它提供了一套标准化框架，用于建立、维护与发布技能，确保存储库符合开放标准的 Agent Skills 规范。对于管理复杂 Agent 生态系统、需要在多个技能存储库间保持一致性的开发者与团队而言，此工具至关重要。它通过自动化结构检查与 CI/CD 管线，弥合了原始开发与生产环境就绪之间的落差。

• 自动化的结构验证，针对 .claude-plugin/plugin.json、composer.json 与 SKILL.md 文件。

• 强制执行分割授权模型 (MIT + CC-BY-SA-4.0)，以同时保护代码与程序性知识。

• 使用已签署的 Git 标签与可重复使用的 GitHub Workflow 调用器 (validate, release, auto-merge-deps, harness-verify) 进行整合式发布管理。

• 支持 Composer (PHP)、npm (Node) 与 Claude Code 市场等多种发布渠道。

• 监控文件、元数据与 Git 发布标签之间的版本一致性。

• 内建适用于 CI 环境的验证脚本，确保代码质量与跨平台 (macOS/Linux) 兼容性。

• 适合开发者构建与部署可携带式 Agent 指令与自动化程序 Agent。

• 使用 validate-skill.sh 脚本进行提交前或 CI 等级的合规检查。

• 请确保 composer.json 使用 'ai-agent-skill' 类型，并依赖 'netresearch/composer-agent-skill-plugin' 以进行正确的依赖发现。

• 遵循推荐的存储库结构，以支持通过 npx (skills.sh) 与市场工具进行自动化安装。

• 在终端机或 CI 环境中运行，需要 bash 4.3+、python3 与 jq 支持。

• 严格遵守语义化版本控制 (SemVer)，通过自动化检查防止软件包版本与 Git 历史记录之间产生偏差。