mcpField
O
oneskill

oneskill

github.com/xu-xiangAgent workflows2.0k39 installsUpdated 34w ago
Repository

About oneskill

OneSkill is a meta-skill for agents to discover and install capabilities. It searches a registry and uses OpenSkills to manage skill installation, updates, and reading, with explicit user confirmation required before installation.

Key features

  1. 01Search skills by keyword or category
  2. 02Sort and paginate search results
  3. 03Install and manage skills with OpenSkills
  4. 04Sync, read, update, or remove skills
  5. 05Map installed skills for Gemini CLI

Use cases

  1. 01Find skills for capabilities an agent lacks
  2. 02Filter skills by areas such as databases or browsers
  3. 03Install and sync skills after user approval
  4. 04Configure skill mappings for Gemini CLI

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/xu-xiang/everything-claude-code-zh --skill oneskill

After installing, type/oneskillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
.openskills.json
LICENSE
package-lock.json
package.json
README_CN.md
README.md
tsconfig.json
tsup.config.ts
src/
cli.ts
src/commands/
doctor.ts
info.ts
list.ts
map.ts
search.ts
sync.ts
src/core/
fs.ts
lock.ts
log.ts
manifest.ts
map.ts
mapping.ts
openskills.ts
registry.ts
root.ts
types.ts
versions.ts
src/utils/
json.ts

Details

From the project README

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

Comments

Markdown supported