skills-template

skills-template

用于创建可复用 agent skills 仓库的模板。仓库以 skills/ 为唯一事实来源，同时提供 Claude Code 插件元信息、Codex 安装脚本、校验脚本和测试夹具。

如何使用这个模板

1. 复制或 clone 本仓库作为你的 skills 仓库起点。
2. 修改 .claude-plugin/plugin.json 和 .claude-plugin/marketplace.json 中的 your-name、your-org、your-org/your-skills-repo。
3. 在 skills/ 下添加你的 skill。
4. 运行校验与测试。
5. 发布前更新 CHANGELOG.md 和插件版本号。

默认内置 Skill

• creating-agent-skills：辅助创建或更新 agent skill 的通用流程。

tests/fixtures/ 中的 demo-skill 只用于测试夹具，不是模板内置 skill。

仓库结构

skills-template/
├─ .claude-plugin/
├─ agents/
├─ hooks/
├─ skills/
│  └─ creating-agent-skills/
├─ scripts/
├─ tests/
├─ CHANGELOG.md
├─ CONTRIBUTING.md
└─ README.md

安装

Claude Code

发布前先把 marketplace 元信息里的占位值替换为你的真实仓库信息。

/plugin marketplace add your-org/your-skills-repo
/plugin install skills-template@skills-template

Codex

Windows PowerShell：

./scripts/install-codex.ps1

macOS/Linux Bash：

bash scripts/install-codex.sh

如需覆盖已有同名 skill：

./scripts/install-codex.ps1 -Force

bash scripts/install-codex.sh --force

如需使用链接模式：

./scripts/install-codex.ps1 -Mode Link

bash scripts/install-codex.sh --mode link

校验与测试

Windows PowerShell：

./scripts/validate-skills.ps1
./tests/validate-skills.ps1

macOS/Linux Bash：

bash scripts/validate-skills.sh
bash tests/validate-skills.sh