Skill1.2k repo starsupdated 3mo ago

oneskill

OneSkill is a meta-manager for discovering, searching, and automatically installing Claude Code skills from registries. Use it when current capabilities lack needed functionality, tasks require specialized domain expertise and repeated attempts have failed, or better-suited skills exist for specific needs like web browsing, GitHub integration, or database management. The tool searches skill registries, analyzes results, confirms selections with users, and installs packages via OpenSkills while handling environment-specific configuration.

View source Repository: everything-claude-code-zh

Install in Claude Code

Copy

git clone --depth 1 https://github.com/xu-xiang/everything-claude-code-zh /tmp/oneskill && cp -r /tmp/oneskill/.claude/skills/oneskill ~/.claude/skills/oneskill

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

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