oneskill

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