@kmiyh/pi-skills-menu 1.2.0 → 1.2.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.
- package/README.md +102 -80
- package/package.json +1 -1
- package/src/images/skill-create-description.jpg +0 -0
- package/src/images/skill-create-generate.jpg +0 -0
- package/src/images/skill-create-name.jpg +0 -0
- package/src/images/skill-create-visibility.jpg +0 -0
- package/src/images/skill-delete.jpg +0 -0
- package/src/images/skill-disable.jpg +0 -0
- package/src/images/skill-edit.jpg +0 -0
- package/src/images/skill-preview.jpg +0 -0
- package/src/images/skill-rename.jpg +0 -0
- package/src/images/skills-menu.jpg +0 -0
- package/src/images/skill-create-generating.jpg +0 -0
package/README.md
CHANGED
|
@@ -1,14 +1,25 @@
|
|
|
1
1
|
# @kmiyh/pi-skills-menu
|
|
2
2
|
|
|
3
|
-
`@kmiyh/pi-skills-menu` is a Pi
|
|
3
|
+
`@kmiyh/pi-skills-menu` is a Pi extension that moves skill browsing and selection into a dedicated `/skills` menu.
|
|
4
|
+
|
|
5
|
+
Instead of filling Pi's main menu with many `/skill:<name>` entries, it gives you one focused place to search, preview, insert, create, edit, rename, delete, and enable or disable skills.
|
|
6
|
+
|
|
7
|
+
## Why use it
|
|
8
|
+
|
|
9
|
+
- keeps the main menu cleaner when many skills are installed
|
|
10
|
+
- puts project, global, and package-provided skills in one searchable list
|
|
11
|
+
- makes skill selection faster in interactive sessions
|
|
12
|
+
- lets you manage your own skills without leaving the TUI
|
|
13
|
+
|
|
14
|
+
## Installation
|
|
4
15
|
|
|
5
16
|
```bash
|
|
6
|
-
/skills
|
|
17
|
+
pi install npm:@kmiyh/pi-skills-menu
|
|
7
18
|
```
|
|
8
19
|
|
|
9
|
-
|
|
20
|
+
## What changes after installation
|
|
10
21
|
|
|
11
|
-
When the extension is installed, it automatically writes
|
|
22
|
+
When the extension is installed, it automatically writes this to `settings.json`:
|
|
12
23
|
|
|
13
24
|
```json
|
|
14
25
|
{
|
|
@@ -16,135 +27,148 @@ When the extension is installed, it automatically writes the following to `setti
|
|
|
16
27
|
}
|
|
17
28
|
```
|
|
18
29
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
## Installation
|
|
30
|
+
That disables the default `/skill:<name>` command registration in the main menu and replaces it with a single `/skills` entry.
|
|
22
31
|
|
|
23
|
-
|
|
32
|
+
When you insert a skill from the menu, the extension adds a marker like this to the editor:
|
|
24
33
|
|
|
25
|
-
```
|
|
26
|
-
|
|
34
|
+
```text
|
|
35
|
+
[skill] my-skill
|
|
27
36
|
```
|
|
28
37
|
|
|
29
|
-
|
|
38
|
+
Before the message is sent, Pi expands that marker into the actual skill content.
|
|
30
39
|
|
|
31
|
-
|
|
40
|
+
## What the `/skills` menu shows
|
|
41
|
+
|
|
42
|
+
The menu includes all available installed skills:
|
|
32
43
|
|
|
33
|
-
- global skills
|
|
34
44
|
- project skills
|
|
35
|
-
- skills
|
|
45
|
+
- global skills
|
|
46
|
+
- skills provided by installed packages/libraries
|
|
36
47
|
|
|
37
|
-
The list is
|
|
48
|
+
The list is grouped into:
|
|
38
49
|
|
|
39
|
-
- **Your Skills** —
|
|
40
|
-
- **Library Skills** — skills coming from
|
|
50
|
+
- **Your Skills** — your own project and global skills
|
|
51
|
+
- **Library Skills** — skills coming from installed packages
|
|
41
52
|
|
|
42
53
|
|
|
43
54
|
|
|
44
|
-
## What
|
|
55
|
+
## What you can do in `/skills`
|
|
45
56
|
|
|
46
|
-
|
|
57
|
+
| Action | Shortcut | Notes |
|
|
58
|
+
| --- | --- | --- |
|
|
59
|
+
| Filter skills by name | type | Search works directly in the list |
|
|
60
|
+
| Open preview | `Tab` | Shows full metadata and content |
|
|
61
|
+
| Insert selected skill | `Enter` | Works only for enabled skills |
|
|
62
|
+
| Enable or disable a skill | `Ctrl+X` | Works for your skills and library skills |
|
|
63
|
+
| Create a new skill | `Enter` on **Create new skill** | Opens the creation flow |
|
|
64
|
+
| Delete your own skill | `Backspace` | Available only for project/global skills you own |
|
|
47
65
|
|
|
48
|
-
|
|
66
|
+
### Preview a skill
|
|
49
67
|
|
|
50
|
-
|
|
68
|
+
Press `Tab` on a selected skill to open preview mode.
|
|
51
69
|
|
|
52
|
-
|
|
70
|
+
The preview shows:
|
|
53
71
|
|
|
54
|
-
-
|
|
72
|
+
- the skill name and scope
|
|
73
|
+
- its source path or package
|
|
74
|
+
- whether it is enabled or disabled
|
|
75
|
+
- the full frontmatter
|
|
76
|
+
- the full skill content with scrolling support
|
|
55
77
|
|
|
56
78
|
|
|
57
79
|
|
|
58
80
|
### Insert a skill into the editor
|
|
59
81
|
|
|
60
|
-
Press
|
|
82
|
+
Press `Enter` on an enabled skill to insert it into the editor.
|
|
61
83
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
After that, the skill is inserted into the editor so it will be used by Pi when the message is sent.
|
|
84
|
+
This is useful when you want to explicitly attach one or more skills to the message you are writing, without manually copying skill content.
|
|
65
85
|
|
|
66
86
|
### Enable or disable a skill
|
|
67
87
|
|
|
68
|
-
Press
|
|
88
|
+
Press `Ctrl+X` to toggle the selected skill.
|
|
69
89
|
|
|
70
|
-
|
|
90
|
+
Disabled skills stay visible in the list and are marked with `[disabled]`, so you can still find them and re-enable them later.
|
|
71
91
|
|
|
72
|
-
This also works for skills that come from installed
|
|
92
|
+
This also works for skills that come from installed packages.
|
|
73
93
|
|
|
74
|
-
|
|
94
|
+
|
|
75
95
|
|
|
76
|
-
|
|
96
|
+
## Creating a new skill
|
|
77
97
|
|
|
78
|
-
|
|
98
|
+
The first row in the menu is **Create new skill**.
|
|
79
99
|
|
|
80
|
-
|
|
100
|
+
Creation is split into three short steps:
|
|
81
101
|
|
|
82
|
-
|
|
102
|
+
1. **Name** — the skill folder/name slug
|
|
103
|
+
2. **Description** — one clear sentence describing what the skill does and when Pi should use it
|
|
104
|
+
3. **Visibility** — whether the skill should be saved globally or only for the current project
|
|
83
105
|
|
|
84
|
-
1.
|
|
106
|
+
### 1. Name
|
|
85
107
|
|
|
86
108
|
|
|
87
109
|
|
|
88
|
-
2.
|
|
110
|
+
### 2. Description
|
|
89
111
|
|
|
90
112
|
|
|
91
113
|
|
|
92
|
-
3.
|
|
93
|
-
|
|
94
|
-
|
|
114
|
+
### 3. Visibility
|
|
115
|
+
|
|
116
|
+
|
|
95
117
|
|
|
96
|
-
After that, the extension generates
|
|
118
|
+
After that, the extension generates `SKILL.md` for you.
|
|
97
119
|
|
|
98
120
|
Generation uses:
|
|
99
121
|
|
|
100
|
-
- the
|
|
101
|
-
- the
|
|
122
|
+
- the model currently selected in the TUI
|
|
123
|
+
- the current thinking level selected in the TUI
|
|
102
124
|
|
|
103
|
-
So
|
|
125
|
+
So the draft follows the model configuration already active in your Pi session.
|
|
104
126
|
|
|
105
|
-
|
|
106
128
|
|
|
107
|
-
##
|
|
129
|
+
## Editing, renaming, and deleting your own skills
|
|
108
130
|
|
|
109
|
-
|
|
131
|
+
Your own project and global skills can be managed directly from preview mode.
|
|
110
132
|
|
|
111
|
-
|
|
112
|
-
- scrolling support for reading the content
|
|
133
|
+
Library skills can be previewed, inserted, and enabled/disabled, but they cannot be edited, renamed, or deleted from this menu.
|
|
113
134
|
|
|
114
|
-
|
|
135
|
+
### Edit skill content
|
|
115
136
|
|
|
116
|
-
|
|
137
|
+
In preview mode, press `e` to edit the skill content and metadata body.
|
|
138
|
+
|
|
139
|
+
Use `Ctrl+S` to save.
|
|
117
140
|
|
|
118
141
|
|
|
119
142
|
|
|
120
|
-
|
|
143
|
+
### Rename a skill
|
|
121
144
|
|
|
122
|
-
|
|
145
|
+
In preview mode, press `r` to rename the skill.
|
|
123
146
|
|
|
124
|
-
|
|
147
|
+
This updates both the directory name and the `name` field in frontmatter.
|
|
125
148
|
|
|
126
|
-
|
|
149
|
+
|
|
127
150
|
|
|
128
|
-
###
|
|
151
|
+
### Delete a skill
|
|
129
152
|
|
|
130
|
-
|
|
153
|
+
In browse mode or preview mode, press `Backspace` to delete your own skill.
|
|
131
154
|
|
|
132
|
-
|
|
133
|
-
.pi/skills/<skill-name>/SKILL.md
|
|
134
|
-
```
|
|
155
|
+
A confirmation dialog is shown before removal.
|
|
135
156
|
|
|
136
|
-
|
|
157
|
+
|
|
137
158
|
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
159
|
+
## Where new skills are saved
|
|
160
|
+
|
|
161
|
+
New skills are stored in Pi's standard skill directories depending on the selected visibility.
|
|
141
162
|
|
|
142
|
-
|
|
163
|
+
| Visibility | Path |
|
|
164
|
+
| --- | --- |
|
|
165
|
+
| Project | `.pi/skills/<skill-name>/SKILL.md` |
|
|
166
|
+
| Global | `~/.pi/agent/skills/<skill-name>/SKILL.md` |
|
|
143
167
|
|
|
144
|
-
|
|
168
|
+
Example project skill:
|
|
145
169
|
|
|
146
170
|
```text
|
|
147
|
-
|
|
171
|
+
.pi/skills/react-review/SKILL.md
|
|
148
172
|
```
|
|
149
173
|
|
|
150
174
|
## Local development
|
|
@@ -167,31 +191,29 @@ Run the extension directly from a local checkout:
|
|
|
167
191
|
pi -e ./src/index.ts
|
|
168
192
|
```
|
|
169
193
|
|
|
170
|
-
##
|
|
194
|
+
## Contributing
|
|
171
195
|
|
|
172
|
-
|
|
196
|
+
Contributions are welcome, especially around:
|
|
173
197
|
|
|
174
|
-
-
|
|
175
|
-
-
|
|
176
|
-
-
|
|
177
|
-
-
|
|
178
|
-
-
|
|
179
|
-
- suggest improvements to project structure and Pi package support
|
|
180
|
-
- etc
|
|
198
|
+
- menu UX and navigation
|
|
199
|
+
- skill search and filtering
|
|
200
|
+
- preview and editing flows
|
|
201
|
+
- skill generation quality
|
|
202
|
+
- Pi package compatibility
|
|
181
203
|
|
|
182
|
-
|
|
204
|
+
Typical workflow:
|
|
183
205
|
|
|
184
206
|
1. fork the repository
|
|
185
|
-
2. create a
|
|
207
|
+
2. create a branch
|
|
186
208
|
3. make your changes
|
|
187
|
-
4. verify
|
|
209
|
+
4. verify with:
|
|
188
210
|
|
|
189
211
|
```bash
|
|
190
212
|
npm install
|
|
191
213
|
npm run typecheck
|
|
192
214
|
```
|
|
193
215
|
|
|
194
|
-
5. test locally
|
|
216
|
+
5. test locally:
|
|
195
217
|
|
|
196
218
|
```bash
|
|
197
219
|
pi -e ./src/index.ts
|
package/package.json
CHANGED
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|