@stefafafan/skm 0.1.2 → 0.1.4

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 (2) hide show
  1. package/README.md +20 -10
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,10 +1,16 @@
1
1
  # skm
2
2
 
3
+ <a href="https://www.npmjs.com/package/@stefafafan/skm"><img alt="NPM Version" src="https://img.shields.io/npm/v/%40stefafafan%2Fskm"></a>
4
+
3
5
  `skm` is a package manager of [Agent Skills](https://agentskills.io), supporting both project and global-level skills.
4
6
 
7
+ See [stefafafan/skm-demo](https://github.com/stefafafan/skm-demo) for real examples of how `skm` is used in a project.
8
+
5
9
  > [!WARNING]
6
10
  > This package is in beta. There may be breaking changes.
7
11
 
12
+ ![skm demo](demo.gif)
13
+
8
14
  ## Motivation
9
15
 
10
16
  Agent Skills are convenient, but there are 2 points to consider:
@@ -35,19 +41,19 @@ npx @stefafafan/skm
35
41
  Initialize a project with `skills.json` and `skills.lock.json`
36
42
 
37
43
  ```bash
38
- skm init --project
44
+ skm init
39
45
  ```
40
46
 
41
47
  Add your favorite skills.
42
48
 
43
49
  ```bash
44
- skm add https://github.com/stefafafan/skills --project
50
+ skm add https://github.com/stefafafan/skills
45
51
  ```
46
52
 
47
53
  Rename a skill locally if you prefer a different key name.
48
54
 
49
55
  ```bash
50
- skm rename pin-github-actions gha-pinner --project
56
+ skm rename pin-github-actions gha-pinner
51
57
  ```
52
58
 
53
59
  Add and commit your files.
@@ -69,10 +75,6 @@ skm init --global
69
75
  skm add stefafafan/skills --global
70
76
  ```
71
77
 
72
- ```bash
73
- skm list --global
74
- ```
75
-
76
78
  ## Commands
77
79
 
78
80
  Call `help` subcommand for more information.
@@ -120,11 +122,19 @@ The following files are used by `skm`
120
122
  The intended manifest-first flow is:
121
123
 
122
124
  1. Change `skills.json` with `skm` commands or by editing it directly.
123
- 2. Run `skm install --project`.
125
+ 2. Run `skm install`.
124
126
  3. Let `skills.lock.json` and `.agents/skills/` reconcile automatically.
125
127
 
126
- It is recommended to add the following to `.gitignore`
128
+ It is recommended to add the `.skm` directory to `.gitignore`.
127
129
 
128
130
  ```sh
129
- .skm
131
+ echo '.skm' >> .gitignore
130
132
  ```
133
+
134
+ ## FAQ
135
+
136
+ ### Q: My Coding Agent doesn't support `.agents/skills`
137
+
138
+ It is a design decision to only support `.agents/skills` for `skm`.
139
+
140
+ If you don't mind, you can use the workaround of symbolic links (e.g. make `.claude/skills` a symlink of `.agents/skills`).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@stefafafan/skm",
3
- "version": "0.1.2",
3
+ "version": "0.1.4",
4
4
  "private": false,
5
5
  "description": "A package manager for AI Agent Skills. Supports installation, version management, and renaming of skills. Can be used for both global and project specific skill management.",
6
6
  "keywords": [