核心用法
local-skill-manager 是一款面向开发者的本地 Skill 目录管理工具，通过标准化脚本实现 Skill 生命周期的集中管控。核心功能覆盖四大场景：查询列出（list_skills.py 扫描系统级与用户级 Skill，输出名称、版本、描述）、版本检查（check_versions.py 提取 SKILL.md 的 YAML frontmatter 版本元数据）、快速创建（create_skill.py 自动生成含 scripts/、references/、assets/ 及标准模板的目录结构）、安全删除（delete_skill.py 移除指定 Skill，系统级受保护 Skill 无法删除）。用户通过自然语言触发（如"列出我的 Skill""创建一个 data-analyzer Skill"），后台调用对应 Python 脚本执行，避免直接操作文件系统。
显著优点
1. 标准化治理：强制统一目录结构与元数据规范，降低多人协作的认知成本
2. 脚本化操作：封装文件系统细节，防止误删或路径错误，删除操作内置保护机制
3. 双语触发：支持中英文自然语言指令，贴合中文开发者习惯
4. 环境隔离：区分系统级与用户级 Skill，避免权限混乱
潜在缺点与局限性
- 依赖外部库：需预先安装
pyyaml，在离线环境或容器内可能受限 - 无版本比对源：仅能读取本地版本号，无法与远程仓库比对判断是否最新
- 无依赖管理：不处理 Skill 之间的依赖关系，删除时可能破坏其他 Skill 的引用
- 路径硬编码风险：虽然支持子目录前缀，但仍需用户手动指定完整路径
适合人群
- 使用 Trae/Claude 等 AI IDE 且 Skill 数量超过 5 个的开发者
- 需要维护团队共享 Skill 库的技术负责人
- 追求本地开发环境整洁、厌恶手动管理目录的自动化爱好者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 误删数据 | 删除脚本未递归检查引用关系 | 删除前手动确认，建议配合 Git 版本控制 |
| YAML 解析失败 | SKILL.md 格式不规范导致 frontmatter 提取异常 | 创建时强制使用模板，定期校验格式 |
| 路径遍历 | 脚本未显式校验输入 Skill 名是否包含 `..` 等特殊字符 | 仅输入纯字母数字连字符组合的 Skill 名 |