用途
Skill 是一个元技能（meta-skill），用于通过类 CLI 命令管理 oh-my-claudecode 的本地技能。它的核心作用是把分散在用户级和项目级目录中的技能进行统一查看、创建、修改和同步。
主要能力
该技能通过 /skill 系列子命令提供以下能力：
- list：展示所有可用技能，按范围（内置 built-in、用户 user、项目 project）分组，解析 YAML frontmatter 并输出为表格。内置技能来自插件 skills/ 目录（只读），用户技能位于 ~/.gemini/antigravity/skills/omc-learned/，项目技能位于 .omc/skills/。若质量或使用统计不可用，则显示 "N/A"。内置技能可发现、可读取，但不能通过 /skill remove 或 /skill edit 删除或编辑。
- add [name]：交互式向导，依次询问技能名称（需小写、仅连字符、不含空格）、描述、触发关键词（逗号分隔）、参数提示（可选）、作用范围（user 或 project），并按模板生成 SKILL.md 文件。
- remove <name>：按名称在两个范围中查找技能，显示技能信息并请求确认，确认后删除整个技能目录。文档明确要求：未经用户明确确认，绝不删除。
- edit <name>：交互式编辑已有技能，可修改 description、triggers、argument-hint、content，也可 rename（移动文件）或 cancel 退出。
- search <query>：按名称、描述、触发词和完整 Markdown 内容进行不区分大小写匹配，展示带上下文的匹配结果；名称/触发词匹配优先于内容匹配。
- info <name>：展示某个技能的详细信息和完整 Markdown 内容，若未找到则提示使用 /skill search。
- sync：比较用户范围与项目范围技能，分类为用户独有、项目独有、共有三类，并提供复制到项目、复制到用户、查看差异、取消等选项。安全要求：未经确认绝不覆盖。
- setup：交互式向导（原 local-skills-setup），先检查并在需要时创建用户级和项目级技能目录，然后扫描并清点技能，最后通过菜单提供添加新技能、列出全部技能、扫描对话中的模式、导入技能、完成等操作。
- scan：仅执行 /skill setup 第二步的扫描，不进入交互向导。
使用方式
以斜杠命令形式调用，例如 /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。
/skill setup 中会用到目录检查与创建命令：
USER_SKILLS_DIR="$HOME/.gemini/antigravity/skills/omc-learned"
if [ -d "$USER_SKILLS_DIR" ]; then
echo "User skills directory exists: $USER_SKILLS_DIR"
else
mkdir -p "$USER_SKILLS_DIR"
echo "Created user skills directory: $USER_SKILLS_DIR"
fi
PROJECT_SKILLS_DIR=".omc/skills"
if [ -d "$PROJECT_SKILLS_DIR" ]; then
echo "Project skills directory exists: $PROJECT_SKILLS_DIR"
else
mkdir -p "$PROJECT_SKILLS_DIR"
echo "Created project skills directory: $PROJECT_SKILLS_DIR"
fi
新增技能时会生成 SKILL.md 模板，包含 YAML frontmatter（name、description、triggers、argument-hint）以及 Purpose、When to Activate、Workflow、Examples、Notes 等章节。
创建技能时可选用四类模板：错误解决方案（Error Solution）、工作流（Workflow）、代码模式（Code Pattern）、集成（Integration），各自带有特定的 frontmatter 字段（如 id、source、quality）和正文结构。
适用场景
适用于需要集中维护 oh-my-claudecode 本地技能库的开发者，例如查看现有技能清单、按关键词检索技能、创建新技能、编辑触发词或描述、在用户级与项目级之间同步技能，以及从对话中识别可沉淀为技能的模式或从 URL/粘贴内容导入技能。
限制
- 内置技能为只读，不能通过 remove 或 edit 修改。
- 删除和覆盖操作都要求用户明确确认。
- 命令需要处理文件/目录不存在、权限错误、无效 YAML frontmatter、重复技能名、无效技能名（含空格或特殊字符）等异常。
- 质量与使用统计可能不可用，此时显示 N/A。
- 文中仅给出了错误输出的格式前缀示例（✗ Error: <clear message> → S...），其余细节暂未提供。