| name | plugin-standardizer |
| description | Convert non-standard Claude Code plugin to standard format. Detects misplaced SKILL.md, skill.json, scripts and restructures to .claude-plugin/plugin.json + skills/name/SKILL.md format. Auto-registers to marketplace.json. |
插件标准化工具
将非标准 Claude Code 插件目录转换为标准插件格式。
触发词
- "标准化插件"
- "转换插件格式"
- "plugin standardize"
- "修复插件结构"
标准格式
plugins/<plugin-name>/
├── .claude-plugin/
│ └── plugin.json ← 插件配置
└── skills/
└── <skill-name>/
├── SKILL.md ← Skill 定义
├── README.md ← 文档（可选）
├── references/ ← 参考文档（可选）
└── scripts/ ← 脚本（可选）
执行流程
1. 检测当前结构
扫描插件目录，识别：
- 根目录
SKILL.md 或 skill.md
- 根目录
skill.json 或 plugin.json
- 根目录
scripts/ 目录
- 根目录
README.md
- 是否存在
.claude-plugin/ 目录
2. 分析并规划
根据检测结果生成转换计划：
| 当前位置 | 目标位置 |
|---|
./SKILL.md | ./skills/<name>/SKILL.md |
./skill.json | ./.claude-plugin/plugin.json |
./scripts/ | ./skills/<name>/scripts/ |
./README.md | ./skills/<name>/README.md |
3. 执行转换
- 创建
.claude-plugin/ 目录
- 创建
skills/<name>/ 目录
- 移动文件到目标位置
- 转换
skill.json 为 plugin.json 格式（如需要）
- 删除旧文件
4. 注册到 marketplace
更新 .claude-plugin/marketplace.json，添加插件条目：
{
"name": "<plugin-name>",
"source": "./plugins/<plugin-name>",
"description": "<从 plugin.json 提取>",
"version": "<从 plugin.json 提取>"
}
5. Git 提交
自动创建两次提交：
feat: add <plugin-name> plugin (wip) - 原始状态refactor: restructure <plugin-name> to standard plugin format - 转换后
plugin.json 模板
{
"name": "<plugin-name>",
"version": "1.0.0",
"description": "<描述>",
"author": {
"name": "<作者>",
"url": "<作者URL>"
},
"homepage": "<项目主页>",
"repository": "<仓库地址>",
"license": "MIT",
"keywords": ["<关键词>"],
"minimum_claude_version": "1.8.0",
"skills": "./skills/"
}
使用方法
/plugin-standardizer <插件目录路径>
示例：
/plugin-standardizer plugins/novel-chapter-parser
注意事项
- 转换前自动 Git 暂存当前状态
- 已是标准格式的插件跳过转换
- 多个 skill 时，每个创建独立
skills/<name>/ 目录
- 保留原有文件内容，仅移动位置
