oneskill 0.1.0 โ†’ 0.1.1

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 +7 -3
  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
@@ -22,12 +22,16 @@ 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:
27
29
  - Explain what the skill does and where it comes from.
28
30
  4. Install after explicit approval (use openskills):
29
- - Run: `npx openskills install <slug-or-repo>`
30
- - Example: `npx openskills install anthropics/skills`
31
+ - IMPORTANT: Do NOT pass the registry `slug` into `openskills install`.
32
+ - Use the `repository` field from `oneskill search` results as the install source:
33
+ - Run: `npx openskills install <repository>` (e.g., `wshobson/agents`)
34
+ - If the repo contains many skills, install without `-y` and select ONLY the needed skill(s) in the picker (by skill name/slug).
31
35
  5. Handle environment-specific setup:
32
36
  - **Gemini CLI Users:** `openskills` does not automatically configure Gemini. You MUST run the mapping command after installation:
33
37
  - `npx oneskill map --target gemini` (add `--global` if installed globally)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "oneskill",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Meta-skill manager for AI coding agents",
5
5
  "type": "module",
6
6
  "main": "./dist/cli.js",