oneskill

by @xu-xiang in AI & LLM

# Install this skill:

npx skills add xu-xiang/oneskill

Or install specific skill: npx add-skill https://github.com/xu-xiang/oneskill

# Description

Discover skills, iterate on queries, and automate skill installations for any environment.

# SKILL.md

name: oneskill
description: Discover skills, iterate on queries, and automate skill installations for any environment.

OneSkill Meta-Manager

Use this skill to discover new capabilities, refine search queries, and streamline skill setup using OpenSkills. This provides a unified way to expand your environment's features.

When to Use

When a user asks for capabilities NOT present in current tools, PRIORITIZE using oneskill search to check availability BEFORE responding.
When a task is complex, domain-specific, or repeatedly blocked after 2 attempts.
When a better skill likely exists (e.g., web browsing, GitHub integration, database management, cloud infrastructure).

Workflow

Search the registry:
Run: npx oneskill search "<query>" [options]
Supported options: --category, --limit, --offset, --sort.
Examples:
- npx oneskill search "browser" --sort stars
- npx oneskill search "" --category database --limit 5
Analyze results:
Pick the best match.
Record BOTH slug and repository.
Treat slug as a registry ID / skill selector label, NOT an OpenSkills install source.
Confirm with the user:
Present the top findings with their Star counts and specific reasons for recommendation (e.g., "High popularity," "Exact feature match").
Explain what the skill does and where it comes from.
Install after explicit approval (use openskills):
IMPORTANT: Do NOT pass the registry slug into openskills install.
Use the repository field from oneskill search results as the install source:
- Run: npx openskills install <repository> (e.g., wshobson/agents)
If the repo contains many skills, install without -y and select ONLY the needed skill(s) in the picker (by skill name/slug).
Handle environment-specific setup:
Gemini CLI Users: openskills does not automatically configure Gemini. You MUST run the mapping command after installation:
- npx oneskill map --target gemini (add --global if installed globally)
Security Inspection:
Quickly review the installed skill's files (prompts/scripts) for malicious intent (e.g., data exfiltration, mining, backdoors).
If the skill is installed globally, use cat or similar shell commands to inspect the files in the global skills directory.
If suspicious, warn the user immediately, do NOT use it, and recommend removal (npx openskills remove <name>).
Apply the new skill to finish the original request.

OpenSkills Basics

npx openskills install <source> [options] # Install from GitHub, local path, or private repo
npx openskills sync [-y] [-o <path>] # Update AGENTS.md (or custom output)
npx openskills list # Show installed skills
npx openskills read <name> # Load skill (for agents)
npx openskills update [name...] # Update installed skills (default: all)
npx openskills manage # Remove skills (interactive)
npx openskills remove <name> # Remove specific skill

Examples:
- npx openskills install anthropics/skills
- npx openskills sync

Defaults: Installs are project-local (./.claude/skills, or ./.agent/skills with --universal). Use --global for ~/.claude/skills.

Safety Reminders

Do not install without explicit user confirmation.
Avoid --force-map unless the user agrees to overwrite an existing target.
Use openskills for installation/updates; OneSkill only searches and maps for Gemini.
For Gemini, run npx oneskill map --target gemini after installs.
Default install/map is project-local, same as openskills; use --global for global installs.
When installing OneSkill itself, recommend --global so it is available across projects.

# README.md

# OneSkill: One to Manage Them All **The "App Store" for your AI Agent.** Discover, install, and map thousands of new capabilities instantly with one click. [![](https://img.shields.io/npm/v/oneskill?color=brightgreen)](https://www.npmjs.com/package/oneskill) [![](https://img.shields.io/npm/l/oneskill)](LICENSE) [**English**](README.md) | [**中文指南**](README_CN.md)

💡 Why OneSkill?

Your AI Agent is strong, but it can be even stronger.

OneSkill is the bridge connecting your Agent to the massive OpenSkills ecosystem (which can be complex to navigate and install manually). By installing just this one tool, your Agent gains the ability to evolve itself: discover new skills, install them more easily, and support a wide range of tools like Codex, Gemini, and more.

No more manual file downloads or configuration edits. Everything is automated.

🚀 Core Value

Massive Skill Library: Instantly connect to thousands of community-maintained Skills (Web browsing, Database management, Code auditing, Cloud infrastructure ops, etc.).
One-Click Installation: A single command handles downloading, dependency resolution, and environment configuration.
Perfect Gemini Adaptation: Developed the map feature for Gemini CLI, automatically injecting Skills downloaded via OpenSkills into Gemini's path.

⚡️ Quick Experience

Step 1: Install OneSkill (Once only)

# Install the core tool
npx openskills install xu-xiang/oneskill --global

# (Only required for Gemini users) Map OneSkill itself to .gemini
npx oneskill map --target gemini --global

Step 2: Unlock Infinite Possibilities

Once installed, simply ask your Agent (Claude Code, Codex, Gemini-cli, etc.) to find and recommend suitable skills or use natural language to have it check for a skill to solve the problem at hand. OneSkill will handle the rest.

Scenario Demo: Autonomous Evolution in Chat

You don't even need to leave the chat window. Just tell your Agent what you need, and let OneSkill do the heavy lifting.

The following real chat record shows how an Agent instantly gains FastAPI development capabilities via OneSkill:

> Find me a production-ready template for FastAPI. I want to build a project quickly.

✦ Sure, I'll use oneskill to search for relevant Skills.

  ╭── Shell: npx oneskill search "fastapi template" ───────────────────────────╮
  │                                                                            │
  │ {                                                                          │
  │   "items": [
  │     {
  │       "slug": "wshobson-fastapi-templates",                                │
  │       "description": "Production-ready FastAPI project structures...",     │
  │       "repository": "wshobson/agents",                                     │
  │       "stars": 23027                                                       │
  │     }
  │   ]
  │ }
  ╰────────────────────────────────────────────────────────────────────────────╯

✦ Found `wshobson-fastapi-templates` in the `wshobson/agents` repository.
  This is a very popular Skill (23k+ stars) that provides a production-grade project structure. Would you like me to install it for you?

> Yes, install it.

✦ Installing and configuring for Gemini...

  ╭── Shell: npx openskills install wshobson/agents && npx oneskill map ───────╮
  │                                                                            │
  │ ✔ Repository cloned                                                        │
  │ Found 140 skill(s)                                                         │
  │                                                                            │
  │ ? Select skills to install: (Press <space> to select, <i> to invert)       │
  │ ❯ ◉ fastapi-templates                                                      │
  │   ◯ architecture-patterns                                                  │
  │   ◯ api-design-principles                                                  │
  │   ↓ Scroll down for more...                                                │
  │                                                                            │
  │ [Agent Action]: Selected 'fastapi-templates' and confirmed                 │
  │                                                                            │
  │ ✅ Installed: fastapi-templates                                            │
  │                                                                            │
  │ [Auto-trigger mapping]                                                     │
  │ ✔ Mapped 1 skills to Gemini CLI configuration.                             │
  ╰────────────────────────────────────────────────────────────────────────────╯

✦ Installation complete! I have learned `fastapi-templates`.
  Now you can ask me: "How do I use this template to create a new project with async mode?"

💥 Result: The Agent automatically completed the search, download, filtering, and environment configuration without you having to type a single command.

📖 Command Reference (Generally, you should use natural language in AI tools; no manual execution required)

1. 🔍 Discovery (`search`)

Don't know what to install? Let OneSkill help you find it.

npx oneskill search "web browser"        # Search for web browsing related skills
npx oneskill search "database" --sort stars  # Search for the most popular database skills

2. ⬇️ Installation (`openskills install`)

Use the standard OpenSkills command for downloads.

npx openskills install <repository-name>
# Example: npx openskills install anthropics/skills

3. 🔌 Environment Mapping (`map`)

Required for Gemini users ONLY

npx oneskill map --target gemini
# If the skill was installed globally, remember to add --global
# npx oneskill map --target gemini --global

4. 📋 View Installed (`list`)

npx openskill list

_{Built with ❤️ by the OneSkill Community}

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.