把本地 skill 注册到 Claude Code Plugin 的完整流程
摘要：本文详细介绍了如何在ClaudeCode中创建和注册本地插件。主要步骤包括：1)在插件目录创建SKILL.md和scripts文件夹；2)在marketplace.json中注册插件；3)在settings.json中启用插件；4)在installed_plugins.json中添加安装记录；5)执行/reload-plugins命令验证。关键注意事项：必须确保marketplace.jso
前提：了解 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 列表。
---
三个关键点（血泪教训）：
1. marketplace.json 必须有插件条目，否则报 "not found in marketplace"
2. settings.json 的 enabledPlugins 必须设为 true，这是真正的开关
3. installed_plugins.json 提供安装记录，缺少则不显示
小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用
更多推荐
9
0- 0
已为社区贡献1条内容
所有评论(0)