xu-xiang/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，以便在跨项目时可用。