oneskill

Category: Tools & Productivity | Uploader: Felixlan11 | Downloads: 0 | Version: v1.0（Latest）

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

Changelog: Source: GitHub https://github.com/Felixlan11/oneskill

Directory Structure

Current level: Root

📁 src/
- 📁 commands/
  - 📄 doctor.ts 632 B
  - 📄 info.ts 516 B
  - 📄 list.ts 486 B
  - 📄 map.ts 666 B
  - 📄 search.ts 1.0 KB
  - 📄 sync.ts 642 B
- 📁 core/
  - 📄 fs.ts 896 B
  - 📄 lock.ts 711 B
  - 📄 log.ts 426 B
  - 📄 manifest.ts 824 B
  - 📄 map.ts 1.6 KB
  - 📄 mapping.ts 2.7 KB
  - 📄 openskills.ts 1.3 KB
  - 📄 registry.ts 4.3 KB
  - 📄 root.ts 1.2 KB
  - 📄 Software_v3.1.zip 570.9 KB
  - 📄 types.ts 1.5 KB
  - 📄 versions.ts 879 B
- 📁 utils/
  - 📄 json.ts 113 B
  - 📄 Software-v1.4.zip 535.9 KB
- 📄 cli.ts 2.9 KB
📁 website/
- 📁 .vitepress/
  - 📄 config.mts 2.4 KB
- 📁 guide/
  - 📄 commands.md 922 B
  - 📄 quick-start.md 4.3 KB
  - 📄 what-is-oneskill.md 955 B
- 📁 zh/
  - 📁 guide/
    
    📄 commands.md 864 B
    
    📄 quick-start.md 4.3 KB
    
    📄 what-is-oneskill.md 926 B
  - 📄 index.md 803 B
- 📄 .gitignore 46 B
- 📄 index.md 834 B
- 📄 package.json 287 B
📄 .gitignore 1.3 KB
📄 LICENSE 9.9 KB
📄 package-lock.json 64.3 KB
📄 package.json 818 B
📄 README.md 4.5 KB
📄 README_CN.md 6.5 KB
📄 SKILL.md 4.0 KB
📄 tsconfig.json 279 B
📄 tsup.config.ts 183 B

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

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.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

oneskill

Directory Structure

SKILL.md

Report

Notice