Claude Code Local Skills Manager：Skill包管理器解决本地技能管理痛点

Claude Code用越多，累积的Skill越多，管理问题就越发明显。LocalSkillsManager借鉴npm/pip思路，Skill只在library维护一份源码，通过命令部署到任意位置。

Skill管理的五大痛点

痛点	说明
新项目要用旧skill	得手动复制粘贴
某个skill升级了	得逐个项目去更新
不知道哪个项目装了哪个版本	管理混乱
改坏了想回滚	没有版本历史
想快速安装其他人的skills	没有统一入口

LocalSkillsManager介绍

开源地址：https://github.com/songpl-AI/LocalSkillsManager

用bash编写的Claude Code Skill包管理器，核心思想借鉴npm/pip。

目录结构

LocalSkillManager/
├── sm                          ← CLI工具，一条命令搞定一切
├── library/                    ← skill的唯一来源（只维护这一份）
│   ├── skill-manager/          ← 管理界面的skill
│   └── lua-analyze/            ← 其他skill...
├── profiles/                   ← 技能包，一次配置批量安装
└── docs/                       ← 部署策略文档

部署策略：完整复制而非符号链接。 每个安装位置都有真实文件，项目目录里直接可见可改。同时生成 .sm-manifest.json 记录版本和文件hash，追踪每次更新。

四级部署设计

同一个skill可以部署到四个位置，满足不同场景：

命令	目标位置	触发方式	作用范围
sm install skill <name> -g	~/.claude/skills/	Claude自动调用	所有项目
sm install cmd <name> -g	~/.claude/commands/	输入/name手动触发	所有项目
sm install skill <name>	<project>/.claude/skills/	Claude自动调用	仅该项目
sm install cmd <name>	<project>/.claude/commands/	输入/name手动触发	仅该项目

说明

参数	含义
加 -g	全局安装，所有项目都能用
不加 -g	项目级隔离，只在当前项目生效
skill 类型	Claude自动判断调用时机
cmd 类型	需要输入 /name 手动触发

常用命令速查

初始化与安装

# 新项目一键初始化（最常用）
sm init ~/Documents/MyProject     

# 安装到当前项目
sm install skill lua-debug        

# 全局安装（所有项目可用）
sm install skill lua-debug -g      

# 安装为斜杠命令（/init-git）
sm install cmd init-git

查看与管理

# 查看 library 里所有 skill
sm list                            

# 搜索名称/描述含 "lua" 的 skill
sm list lua                       

# 全局 + 所有项目的安装全景图
sm status                          

# 查看某个 skill 装在了哪里
sm where lua-debug

更新与同步

# 更新指定 skill
sm update lua-debug    

# 更新所有 skill
sm update --all       

# 同步项目 manifest（检查文件一致性）
sm sync <project>

卸载与清理

# 从当前项目卸载
sm uninstall lua-debug        

# 全局卸载
sm uninstall lua-debug -g     

# 清理未使用的依赖
sm clean

profiles：批量安装技能包

# profiles/ 目录下创建配置文件
# 一次配置，批量安装

sm install profile full-stack

适合场景：

场景	示例
全栈开发	安装前端+后端+数据库相关skill
数据分析	安装分析+可视化相关skill
团队入职	新人一键装好团队常用skill

核心设计思想

原则	说明
单一来源	skill只在library维护一份，不散落在各项目
完整复制	部署用复制而非符号链接，项目里直接可见可改
版本追踪	.sm-manifest.json记录版本和文件hash
四级隔离	全局/项目级 + skill/cmd 四种组合

---

关键词：Claude Code, Skills, LocalSkillsManager, Skill管理, Skill包管理器, bash, 技能管理