oneskill

---
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

1. 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`
2. 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.
3. 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.
4. 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).
5. 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)
   - **Qwen Code CLI Users:** `openskills` does not automatically configure Qwen. You MUST run the mapping command after installation:
     - `npx oneskill map --target qwen` (add `--global` if installed globally)
6. 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>`).
7. 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/Qwen.
- For Gemini/Qwen, run `npx oneskill map --target <env>` 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.