oneskill 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +94 -124
  2. package/SKILL.md +14 -5
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,171 +1,141 @@
1
1
  <div align="center">
2
2
 
3
- # OneSkill Meta-Manager
3
+ # OneSkill: One to Manage Them All
4
4
 
5
- **The universal bridge for AI Agent Skills.**
6
- Discover, install, and map capabilities from the OpenSkills registry to your environment.
5
+ **The "App Store" for your AI Agent.**
6
+ Discover, install, and map thousands of new capabilities instantly with one click.
7
7
 
8
8
  [![](https://img.shields.io/npm/v/oneskill?color=brightgreen)](https://www.npmjs.com/package/oneskill)
9
9
  [![](https://img.shields.io/npm/l/oneskill)](LICENSE)
10
10
 
11
- [**🇺🇸 English**](#-english) | [**🇨🇳 中文指南**](#-中文指南)
11
+ [**English**](README.md) | [**中文指南**](README_CN.md)
12
12
 
13
13
  </div>
14
14
 
15
15
  ---
16
16
 
17
- <a name="-english"></a>
17
+ ## 💡 Why OneSkill?
18
18
 
19
- ## ⚡️ What is OneSkill?
19
+ Your AI Agent is strong, but it can be even stronger.
20
20
 
21
- **OneSkill** is a meta-tool designed for AI Agents (and humans) to easily extend their capabilities. It serves as a search engine and workflow manager for the [OpenSkills](https://github.com/Starttoaster/openskills) ecosystem.
21
+ **OneSkill** is the bridge connecting your Agent to the massive [OpenSkills](https://github.com/Starttoaster/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.**
22
22
 
23
- While `openskills` handles the raw installation of files, **OneSkill** provides:
24
- 1. **Intelligent Search**: Find the right tool for the job using natural language or keywords.
25
- 2. **Workflow Guidance**: A standardized process for Agents to acquire new skills safely.
26
- 3. **Environment Mapping**: Crucially, it bridges the gap between `openskills` (standard structure) and consumers like **Gemini CLI** (custom structure).
23
+ No more manual file downloads or configuration edits. Everything is automated.
27
24
 
28
- ## 🚀 Quick Start
25
+ ## 🚀 Core Value
29
26
 
30
- You don't need to install it permanently. Just run it with `npx`.
27
+ * **Massive Skill Library**: Instantly connect to thousands of community-maintained Skills (Web browsing, Database management, Code auditing, Cloud infrastructure ops, etc.).
28
+ * **One-Click Installation**: A single command handles downloading, dependency resolution, and environment configuration.
29
+ * **Perfect Gemini Adaptation**: Developed the `map` feature for Gemini CLI, automatically injecting Skills downloaded via OpenSkills into Gemini's path.
31
30
 
32
- ```bash
33
- # Search for a skill (e.g., to browse the web)
34
- npx oneskill search "puppeteer browser"
35
-
36
- # Search for database tools sorted by popularity
37
- npx oneskill search "database" --sort stars
38
- ```
39
-
40
- ## 🛠 Workflow
41
-
42
- The standard lifecycle for adding a new capability to your Agent:
31
+ ---
43
32
 
44
- 1. **Search**: Find a skill.
45
- ```bash
46
- npx oneskill search "github integration"
47
- ```
48
- 2. **Install**: Use the standard `openskills` installer.
49
- ```bash
50
- npx openskills install anthropics/skills
51
- ```
52
- 3. **Map (Important for Gemini)**: If you are using **Gemini CLI**, you must map the installed skills to your configuration.
53
- ```bash
54
- # Maps installed skills to Gemini's config
55
- npx oneskill map --target gemini
56
- ```
33
+ ## ⚡️ Quick Experience
57
34
 
58
- ## 📖 Command Reference
35
+ ### Step 1: Install OneSkill (Once only)
59
36
 
60
- ### `search`
61
- Search the global registry for skills.
62
37
  ```bash
63
- npx oneskill search <query> [options]
38
+ # Install the core tool
39
+ npx openskills install xu-xiang/oneskill --global
64
40
 
65
- # Options:
66
- # --category <name> Filter by category
67
- # --sort <field> Sort by 'stars', 'created', or 'updated'
68
- # --limit <number> Limit results (default: 10)
41
+ # (Only required for Gemini users) Map OneSkill itself to .gemini
42
+ npx oneskill map --target gemini --global
69
43
  ```
70
44
 
71
- ### `map`
72
- Generates configuration for specific agent environments.
73
- ```bash
74
- npx oneskill map --target <env>
75
-
76
- # Targets:
77
- # gemini Generate/Update Gemini CLI config
45
+ ### Step 2: Unlock Infinite Possibilities
46
+
47
+ 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.
48
+
49
+ #### Scenario Demo: Autonomous Evolution in Chat
50
+
51
+ You don't even need to leave the chat window. Just tell your Agent what you need, and let OneSkill do the heavy lifting.
52
+
53
+ The following real chat record shows how an Agent instantly gains **FastAPI development capabilities** via OneSkill:
54
+
55
+ ```text
56
+ > Find me a production-ready template for FastAPI. I want to build a project quickly.
57
+
58
+ ✦ Sure, I'll use oneskill to search for relevant Skills.
59
+
60
+ ╭── Shell: npx oneskill search "fastapi template" ───────────────────────────╮
61
+ │ │
62
+ │ { │
63
+ │ "items": [
64
+ │ {
65
+ │ "slug": "wshobson-fastapi-templates", │
66
+ │ "description": "Production-ready FastAPI project structures...", │
67
+ │ "repository": "wshobson/agents", │
68
+ │ "stars": 23027 │
69
+ │ }
70
+ │ ]
71
+ │ }
72
+ ╰────────────────────────────────────────────────────────────────────────────╯
73
+
74
+ ✦ Found `wshobson-fastapi-templates` in the `wshobson/agents` repository.
75
+ This is a very popular Skill (23k+ stars) that provides a production-grade project structure. Would you like me to install it for you?
76
+
77
+ > Yes, install it.
78
+
79
+ ✦ Installing and configuring for Gemini...
80
+
81
+ ╭── Shell: npx openskills install wshobson/agents && npx oneskill map ───────╮
82
+ │ │
83
+ │ ✔ Repository cloned │
84
+ │ Found 140 skill(s) │
85
+ │ │
86
+ │ ? Select skills to install: (Press <space> to select, <i> to invert) │
87
+ │ ❯ ◉ fastapi-templates │
88
+ │ ◯ architecture-patterns │
89
+ │ ◯ api-design-principles │
90
+ │ ↓ Scroll down for more... │
91
+ │ │
92
+ │ [Agent Action]: Selected 'fastapi-templates' and confirmed │
93
+ │ │
94
+ │ ✅ Installed: fastapi-templates │
95
+ │ │
96
+ │ [Auto-trigger mapping] │
97
+ │ ✔ Mapped 1 skills to Gemini CLI configuration. │
98
+ ╰────────────────────────────────────────────────────────────────────────────╯
99
+
100
+ ✦ Installation complete! I have learned `fastapi-templates`.
101
+ Now you can ask me: "How do I use this template to create a new project with async mode?"
78
102
  ```
79
103
 
80
- ### `list`
81
- List locally mapped skills (wrapper around openskills list).
82
- ```bash
83
- npx oneskill list
84
- ```
104
+ **💥 Result**: The Agent automatically completed the search, download, filtering, and environment configuration without you having to type a single command.
85
105
 
86
106
  ---
87
107
 
88
- <br>
89
- <br>
90
-
91
- <a name="-中文指南"></a>
92
-
93
- ## 🇨🇳 中文指南
94
-
95
- [**⬆️ Back to English**](#-english)
96
-
97
- **OneSkill** 是一个为 AI Agent 设计的通用技能管理工具。它作为 [OpenSkills](https://github.com/Starttoaster/openskills) 生态系统的搜索引擎和工作流管理器，帮助你发现、安装并将能力映射到你的运行环境中。
98
-
99
- ### 核心功能
100
-
101
- 1. **智能搜索**: 支持通过自然语言或关键词搜索注册表中的 Skill。
102
- 2. **工作流引导**: 为 Agent 提供了一套标准的扩展能力流程（搜索 -> 确认 -> 安装）。
103
- 3. **环境映射**: 解决了安装路径与运行环境不一致的问题。特别是对于 **Gemini CLI** 用户，OneSkill 能自动将下载的 Skill 映射到 Gemini 的配置文件中。
104
-
105
- ### 🚀 快速开始
106
-
107
- 无需全局安装，直接使用 `npx` 运行即可：
108
+ ## 📖 Command Reference (Generally, you should use natural language in AI tools; no manual execution required)
108
109
 
110
+ ### 1. 🔍 Discovery (`search`)
111
+ Don't know what to install? Let OneSkill help you find it.
109
112
  ```bash
110
- # 搜索技能 (例如：想要网页浏览能力)
111
- npx oneskill search "puppeteer browser"
112
-
113
- # 搜索数据库相关技能，并按星级排序
114
- npx oneskill search "database" --sort stars
113
+ npx oneskill search "web browser" # Search for web browsing related skills
114
+ npx oneskill search "database" --sort stars # Search for the most popular database skills
115
115
  ```
116
116
 
117
- ### 🛠 使用流程
118
-
119
- 为你的 Agent 添加新能力的推荐步骤：
120
-
121
- 1. **搜索 (Search)**: 查找你需要的技能。
122
- ```bash
123
- npx oneskill search "github integration"
124
- ```
125
-
126
- 2. **安装 (Install)**: 使用 `openskills` 标准命令进行下载。
127
- ```bash
128
- npx openskills install anthropics/skills
129
- ```
130
-
131
- 3. **映射 (Map)**: **(Gemini 用户必读)**
132
- `openskills` 默认将文件下载到通用目录，Gemini CLI 无法直接读取。必须执行映射命令：
133
- ```bash
134
- # 自动识别已安装的 Skill 并配置到 Gemini
135
- npx oneskill map --target gemini
136
- ```
137
- *如果你的 Skill 是全局安装的 (加了 --global)，这里也需要加 --global。*
138
-
139
- ### 📖 命令参考
140
-
141
- #### `search` (搜索)
142
- 在全局注册表中搜索技能。
117
+ ### 2. ⬇️ Installation (`openskills install`)
118
+ Use the standard OpenSkills command for downloads.
143
119
  ```bash
144
- npx oneskill search <查询词> [选项]
145
-
146
- # 选项:
147
- # --category <name> 按分类筛选
148
- # --sort <field> 排序方式: 'stars' (星级), 'created' (创建时间), 'updated' (更新时间)
149
- # --limit <number> 限制返回数量 (默认: 10)
120
+ npx openskills install <repository-name>
121
+ # Example: npx openskills install anthropics/skills
150
122
  ```
151
123
 
152
- #### `map` (映射)
153
- 为特定环境生成配置。
124
+ ### 3. 🔌 Environment Mapping (`map`)
125
+ **Required for Gemini users ONLY**
154
126
  ```bash
155
- npx oneskill map --target <环境>
156
-
157
- # 支持的目标:
158
- # gemini 更新 Gemini CLI 的配置与路径映射
127
+ npx oneskill map --target gemini
128
+ # If the skill was installed globally, remember to add --global
129
+ # npx oneskill map --target gemini --global
159
130
  ```
160
131
 
161
- #### `list` (列表)
162
- 查看本地已安装的技能。
132
+ ### 4. 📋 View Installed (`list`)
163
133
  ```bash
164
- npx oneskill list
134
+ npx openskill list
165
135
  ```
166
136
 
167
137
  ---
168
138
 
169
139
  <div align="center">
170
140
  <sub>Built with ❤️ by the OneSkill Community</sub>
171
- </div>
141
+ </div>
package/SKILL.md CHANGED
@@ -9,7 +9,7 @@ Use this skill to discover new capabilities, refine search queries, and streamli
9
9
 
10
10
  ## When to Use
11
11
 
12
- - When a user asks for capabilities you do not currently have.
12
+ - When a user asks for capabilities NOT present in current tools, PRIORITIZE using `oneskill search` to check availability BEFORE responding.
13
13
  - When a task is complex, domain-specific, or repeatedly blocked after 2 attempts.
14
14
  - When a better skill likely exists (e.g., web browsing, GitHub integration, database management, cloud infrastructure).
15
15
 
@@ -22,16 +22,25 @@ Use this skill to discover new capabilities, refine search queries, and streamli
22
22
  - `npx oneskill search "browser" --sort stars`
23
23
  - `npx oneskill search "" --category database --limit 5`
24
24
  2. Analyze results:
25
- - Identify the best match or refine the query and search again.
25
+ - Pick the best match.
26
+ - Record BOTH `slug` and `repository`.
27
+ - Treat `slug` as a registry ID / skill selector label, NOT an OpenSkills install source.
26
28
  3. Confirm with the user:
29
+ - Present the top findings with their **Star counts** and specific **reasons for recommendation** (e.g., "High popularity," "Exact feature match").
27
30
  - Explain what the skill does and where it comes from.
28
31
  4. Install after explicit approval (use openskills):
29
- - Run: `npx openskills install <slug-or-repo>`
30
- - Example: `npx openskills install anthropics/skills`
32
+ - IMPORTANT: Do NOT pass the registry `slug` into `openskills install`.
33
+ - Use the `repository` field from `oneskill search` results as the install source:
34
+ - Run: `npx openskills install <repository>` (e.g., `wshobson/agents`)
35
+ - If the repo contains many skills, install without `-y` and select ONLY the needed skill(s) in the picker (by skill name/slug).
31
36
  5. Handle environment-specific setup:
32
37
  - **Gemini CLI Users:** `openskills` does not automatically configure Gemini. You MUST run the mapping command after installation:
33
38
  - `npx oneskill map --target gemini` (add `--global` if installed globally)
34
- 6. Apply the new skill to finish the original request.
39
+ 6. Security Inspection:
40
+ - Quickly review the installed skill's files (prompts/scripts) for malicious intent (e.g., data exfiltration, mining, backdoors).
41
+ - If the skill is installed globally, use `cat` or similar shell commands to inspect the files in the global skills directory.
42
+ - If suspicious, warn the user immediately, do NOT use it, and recommend removal (`npx openskills remove <name>`).
43
+ 7. Apply the new skill to finish the original request.
35
44
 
36
45
  ## OpenSkills Basics
37
46
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oneskill",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Meta-skill manager for AI coding agents",
5
5
  "type": "module",
6
6
  "main": "./dist/cli.js",