用途
Skill 是 oh-my-claudecode 的元技能(meta-skill),用于通过类 CLI 命令管理本地技能。它面向需要创建、检索、编辑、同步和盘点本地技能的用户,帮助在用户级与项目级作用域中统一管理技能文件。
主要能力
Skill 提供以下子命令:
/skill list:按作用域展示所有可用技能。会扫描插件 skills/ 目录中的内置技能(只读)、用户技能目录${CLAUDE_CONFIG_DIR:-~/.claude}/skills/omc-learned/以及项目技能目录.omc/skills/,解析 YAML frontmatter 元数据并以表格展示。若质量/使用统计不可用,显示 "N/A"。内置技能可被发现和读取,但不能通过/skill remove或/skill edit删除或编辑。/skill add [name]:交互式向导创建新技能。会询问技能名称(校验:小写、仅连字符、无空格)、描述、触发词(逗号分隔)、参数提示(可选)和作用域(user 或 project),然后按模板创建 SKILL.md 文件并报告路径。/skill remove <name>:按名称删除技能。会在两个作用域中查找,显示技能信息并请求确认(yes/no),确认后删除整个技能目录。安全约束:未经用户明确确认绝不删除。/skill edit <name>:交互式编辑已有技能。可修改 description、triggers、argument-hint、content,或执行 rename(移动文件),也可 cancel 退出。/skill search <query>:按内容、触发词、名称或描述搜索技能,大小写不敏感,匹配名称、描述、触发词和完整 markdown 内容,并优先展示名称/触发词匹配。/skill info <name>:展示技能详细信息,包括作用域、描述、触发词、参数提示、质量(如可用)、使用次数(如可用)、文件路径和完整内容。/skill sync:在用户与项目作用域之间同步技能。会分类用户独有、项目独有和共有技能,并提供复制用户技能到项目、复制项目技能到用户、查看差异或取消等选项。安全约束:未经确认绝不覆盖。/skill setup:交互式向导,用于设置和管理本地技能(原 local-skills-setup)。包含目录检查与创建、技能扫描与盘点、快捷操作菜单(添加新技能、列出全部技能、扫描对话中的模式、导入技能、完成)。/skill scan:快速扫描两个技能目录,是/skill setup第 2 步的非交互子集。
使用方式
通过 /skill 后接子命令调用,例如 /skill list、/skill add custom-logger、/skill remove old-logger、/skill edit custom-logger、/skill search api endpoint、/skill info custom-logger、/skill sync、/skill setup、/skill scan。
创建技能时,向导会生成包含 YAML frontmatter(name、description、triggers、argument-hint)和 markdown 正文(Purpose、When to Activate、Workflow、Examples、Notes)的模板。
/skill setup 中提供快捷模板:Error Solution Template、Workflow Skill Template、Code Pattern Template、Integration Skill Template,分别用于错误解决方案、工作流、代码模式和集成场景。
/skill setup 的导入技能选项支持从 URL 下载(如 GitHub gist)或直接粘贴 markdown 内容,并选择用户级或项目级作用域。
适用场景
- 需要集中查看和管理内置、用户级、项目级技能时。
- 需要快速创建带触发词和参数提示的新技能时。
- 需要在用户作用域与项目作用域之间同步或复制技能时。
- 需要按关键词检索技能内容或查看技能完整详情时。
- 需要从对话中识别可沉淀为技能的模式时(通过
/skillify;/learner为已弃用的兼容项)。
限制
- 内置技能为只读,不能通过
/skill remove或/skill edit删除或编辑。 - 删除和同步操作均需用户明确确认,不会自动覆盖。
- 技能名称必须为小写、仅含连字符、无空格。
- 质量与使用次数统计可能不可用,此时显示 "N/A"。
- 所有命令需处理文件/目录不存在、权限错误、无效 YAML frontmatter、重复技能名、无效技能名(空格、特殊字符)等错误情况。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。