把本地 skill 注册到 Claude Code Plugin 的完整流程

前提:了解 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 提供安装记录,缺少则不显示

相关推荐
2301_7671139810 天前
点过“不再询问”就要检查:Claude Code权限文件也可能存着密钥
git·信息安全·claude code
yz_aiks15 天前
Postman 自动给 Claude Code、Codex、Cursor 装插件怎么查和卸载:本机实测 5 处痕迹(Postman 12.34)
安全·postman·ai编程·开发工具·claude code
VIP_CQCRE18 天前
Claude Code 如何接入 Ace Data Cloud?终端与 VS Code 配置指南
api·ai编程·vs code·claude code·ace data cloud
Aman198418 天前
Claude Code做Unity项目移植(二): 自动执行只读操作,告别频繁的
unity·游戏开发·vibe coding·claude code
GoldenSpider.AI19 天前
一张户型图做成浏览器 3D 漫游:house.json 统一模型、1.2 m 剖切图纸与分阶段验收
ai编程·webgl·three.js·3d漫游·claude code
瓶 盖19 天前
你的 IDE 插件改了 authorized_keys:Claude Code 扩展投毒链路拆解
ide·ssh·vs code·安全分析·供应链安全·claude code
Aman198420 天前
Claude Code做Unity项目移植(一):从零散工具到团队式
unity·游戏开发·vibe coding·claude code·项目迁移
deepseek2320 天前
Claude Code 2.1.314 新增工作目录写入边界:工具权限、沙箱与安全盲区怎么分层
人工智能·ai agent·claude code
yz_aiks20 天前
WorkBuddy 使用技巧:Claude Code 国内平替,签到免费用、自动签到和手机远程控制电脑
人工智能·ai编程·效率工具·claude code·workbuddy
A.说学逗唱的Coke21 天前
【大模型专题】大模型怎么选(2026 年 10 月版):从 20 个模型里挑对那 3 个,以及 Agent 按角色分模型的实操矩阵
ai agent·claude code·大模型选型·模型路由·多模型编排