前提：了解 local-skills marketplace
Claude Code 通过 known_marketplaces.json 管理 marketplace。本地目录类型的
marketplace 结构：
/Users/你的名字/code/skills/ ← marketplace 根目录
├── .claude-plugin/
│ └── marketplace.json ← marketplace 索引（必须）
├── badcase-analyzer/ ← 每个插件一个目录
│ ├── SKILL.md
│ └── scripts/
└── 你的新插件/
├── SKILL.md
└── scripts/
步骤一：在插件目录下创建 SKILL.md 和 scripts
SKILL.md 格式：
name: 插件名
description: 描述（触发条件写清楚）
插件标题
...
步骤二：在 marketplace.json 中注册插件
编辑 /Users/10010906/code/skills/.claude-plugin/marketplace.json，在 plugins
数组里加一条：
{
"name": "你的插件名",
"description": "简短描述",
"category": "productivity",
"source": "./你的插件目录名"
}
步骤三：在 settings.json 中启用插件
编辑 ~/.claude/settings.json，在 enabledPlugins 里加：
"你的插件名@local-skills": true
步骤四：在 installed_plugins.json 中添加安装记录
编辑 ~/.claude/plugins/installed_plugins.json，加一条：
"你的插件名@local-skills": [
{
"scope": "user",
"installPath":
"/Users/10010906/.claude/plugins/cache/local-skills/你的插件名/unknown",
"version": "unknown",
"installedAt": "2026-04-29T00:00:00.000Z",
"lastUpdated": "2026-04-29T00:00:00.000Z"
}
]
同时把插件文件复制到 cache 目录：
cp -r /Users/10010906/code/skills/你的插件名 \
~/.claude/plugins/cache/local-skills/你的插件名/unknown
步骤五：运行 /reload-plugins
验证 plugin 数量是否增加，查看 /plugin 列表。
三个关键点（血泪教训）：
-
marketplace.json 必须有插件条目，否则报 "not found in marketplace"
-
settings.json 的 enabledPlugins 必须设为 true，这是真正的开关
-
installed_plugins.json 提供安装记录，缺少则不显示