/oneskill

name: oneskill
description: 发现技能（Skill），迭代查询，并在任何环境中自动安装技能。

OneSkill 元管理器（Meta-Manager）

使用此技能（Skill）来发现新功能、优化搜索查询，并使用 OpenSkills 简化技能设置。这为扩展环境功能提供了一种统一的方式。

何时使用

• 当用户要求的某些功能你目前不具备时。
• 当任务复杂、属于特定领域，或在尝试 2 次后仍被反复阻断时。
• 当可能存在更好的技能（Skill）时（例如：网页浏览、GitHub 集成、数据库管理、云基础设施）。

工作流（Workflow）

1. **搜索注册表**：

• 运行：`npx oneskill search "<query>" [options]`
• 支持的选项：`--category`、`--limit`、`--offset`、`--sort`。
• 示例：
• `npx oneskill search "browser" --sort stars`
• `npx oneskill search "" --category database --limit 5`

2. **分析结果**：

• 确定最佳匹配项，或优化查询并再次搜索。

3. **与用户确认**：

• 说明该技能的功能及其来源。

4. **在获得明确批准后进行安装（使用 openskills）**：

• 运行：`npx openskills install <slug-or-repo>`
• 示例：`npx openskills install anthropics/skills`

5. **处理特定环境的设置**：

• **Gemini CLI 用户**：`openskills` 不会自动配置 Gemini。安装后你**必须**运行映射命令：
• `npx oneskill map --target gemini`（如果是全局安装，请添加 `--global`）

6. **应用新技能以完成原始请求**。

OpenSkills 基础

• `npx openskills install <source> [options]` # 从 GitHub、本地路径或私有仓库安装
• `npx openskills sync [-y] [-o <path>]` # 更新 AGENTS.md（或自定义输出）
• `npx openskills list` # 显示已安装的技能
• `npx openskills read <name>` # 加载技能（供智能体（Agent）使用）
• `npx openskills update [name...]` # 更新已安装的技能（默认：全部）
• `npx openskills manage` # 移除技能（交互式）
• `npx openskills remove <name>` # 移除特定技能

示例：

• `npx openskills install anthropics/skills`
• `npx openskills sync`

默认设置：安装在项目本地（`./.claude/skills`，或者带 `--universal` 参数安装在 `./.agent/skills`）。使用 `--global` 安装在 `~/.claude/skills`。

安全提示（Safety Reminders）

• 未经用户明确确认，请勿安装。
• 除非用户同意覆盖现有目标，否则避免使用 `--force-map`。
• 使用 openskills 进行安装/更新；OneSkill 仅为 Gemini 提供搜索和映射。
• 对于 Gemini，请在安装后运行 `npx oneskill map --target gemini`。
• 默认安装/映射是项目本地的，与 openskills 相同；全局安装请使用 `--global`。
• 安装 OneSkill 本身时，建议使用 `--global`，以便在跨项目时可用。