mcpField
O
oneskill

oneskill

github.com/xu-xiangAgent 工作流2.0k39 次安装34 周前更新
代码仓库

关于 oneskill

OneSkill 是帮助 Agent 发现和安装技能的元管理技能,通过注册表搜索技能,并借助 OpenSkills 管理安装、更新与读取。安装前要求获得用户明确确认。

主要功能

  1. 01按关键词或类别搜索技能
  2. 02支持排序和分页筛选结果
  3. 03通过 OpenSkills 安装和管理技能
  4. 04同步、读取、更新或移除技能
  5. 05为 Gemini CLI 映射已安装技能

适用场景

  1. 01为缺少特定能力的 Agent 查找技能
  2. 02按数据库或浏览器等类别筛选
  3. 03在确认后安装并同步技能
  4. 04为 Gemini CLI 配置技能映射

安装

复制下面的命令,在终端中运行。

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

安装后在 Claude Code 中输入/oneskill确认已加载。

包含的文件

除 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

详细介绍

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

评论

支持 Markdown