# Oneskill

> 发现技能（Skill），迭代查询，并在任何环境中自动安装技能。 Use when this capability is needed.

- Skill: `tomevault-io/oneskill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/oneskill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/oneskill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/oneskill

---


# 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`，以便在跨项目时可用。

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/xu-xiang) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->