@almyty/skills 1.5.1 → 1.5.3
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 +19 -18
- package/dist/client.js +2 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -9,10 +9,11 @@ more — plus the universal `.agents/skills/` convention.
|
|
|
9
9
|
## Quick start
|
|
10
10
|
|
|
11
11
|
```bash
|
|
12
|
-
$
|
|
13
|
-
$
|
|
14
|
-
$
|
|
15
|
-
$
|
|
12
|
+
$ npm i -g @almyty/cli
|
|
13
|
+
$ almyty login
|
|
14
|
+
$ almyty skills gateways
|
|
15
|
+
$ almyty skills install org/gateway --dry-run # see the exact files
|
|
16
|
+
$ almyty skills install org/gateway
|
|
16
17
|
```
|
|
17
18
|
|
|
18
19
|
## Commands
|
|
@@ -43,8 +44,8 @@ and installs only when it matches exactly one skill; an ambiguous name
|
|
|
43
44
|
lists the matches and exits `2` rather than guessing.
|
|
44
45
|
|
|
45
46
|
```bash
|
|
46
|
-
$
|
|
47
|
-
$
|
|
47
|
+
$ almyty skills install acme/petstore
|
|
48
|
+
$ almyty skills run acme/petstore/get-pet --id 123
|
|
48
49
|
```
|
|
49
50
|
|
|
50
51
|
## Where skills get installed
|
|
@@ -68,7 +69,7 @@ about to write to before it writes anything, reports how many files it
|
|
|
68
69
|
replaced, and `--dry-run` lists every path and writes nothing:
|
|
69
70
|
|
|
70
71
|
```bash
|
|
71
|
-
$
|
|
72
|
+
$ almyty skills install acme/petstore --dry-run
|
|
72
73
|
|
|
73
74
|
acme/petstore (12 skill(s)) — dry run, nothing will be written:
|
|
74
75
|
Codex: /work/proj/.codex/skills
|
|
@@ -111,14 +112,14 @@ Re-run without --dry-run to write them.
|
|
|
111
112
|
| `--dry-run` | Print every file `install` would write, and write nothing. |
|
|
112
113
|
|
|
113
114
|
```bash
|
|
114
|
-
$
|
|
115
|
-
$
|
|
116
|
-
$
|
|
117
|
-
$
|
|
118
|
-
$
|
|
119
|
-
$
|
|
120
|
-
$
|
|
121
|
-
$
|
|
115
|
+
$ almyty skills install acme/petstore # interactive picker
|
|
116
|
+
$ almyty skills install acme/petstore --all # every project-detected
|
|
117
|
+
$ almyty skills install acme/petstore --all --global # project AND home detected
|
|
118
|
+
$ almyty skills install acme/petstore --global # only home-detected agents
|
|
119
|
+
$ almyty skills install acme/petstore -a codex # codex, at whichever scope it lives
|
|
120
|
+
$ almyty skills install acme/petstore -a codex --global # force ~/.codex/skills
|
|
121
|
+
$ almyty skills install acme/petstore --agent '*' -y # every known agent, project scope
|
|
122
|
+
$ almyty skills install acme/petstore -p ./agents/skills # a directory you name
|
|
122
123
|
```
|
|
123
124
|
|
|
124
125
|
`src/agents.ts` is the registry: each entry maps a detection directory
|
|
@@ -149,7 +150,7 @@ other read command prints for humans by default and takes `--json`.
|
|
|
149
150
|
| `0` | success |
|
|
150
151
|
| `1` | unexpected error |
|
|
151
152
|
| `2` | usage error (bad flags, unknown command, ambiguous ref) |
|
|
152
|
-
| `3` | not authenticated — run `
|
|
153
|
+
| `3` | not authenticated — run `almyty login` |
|
|
153
154
|
| `4` | no such gateway or skill |
|
|
154
155
|
| `5` | the skill ran and failed |
|
|
155
156
|
|
|
@@ -174,7 +175,7 @@ other read command prints for humans by default and takes `--json`.
|
|
|
174
175
|
| `interval` | `daemon`/`watch` poll interval, in seconds |
|
|
175
176
|
|
|
176
177
|
There is **no credential key**. The token lives only in
|
|
177
|
-
`~/.almyty/credentials.json` (written by `
|
|
178
|
+
`~/.almyty/credentials.json` (written by `almyty login`) or in
|
|
178
179
|
`ALMYTY_TOKEN`.
|
|
179
180
|
|
|
180
181
|
## Environment variables
|
|
@@ -190,7 +191,7 @@ There is **no credential key**. The token lives only in
|
|
|
190
191
|
|
|
191
192
|
## Authentication
|
|
192
193
|
|
|
193
|
-
Run `
|
|
194
|
+
Run `almyty login` once. `search` and `list` are org-scoped —
|
|
194
195
|
they look through the gateways your account can see, so there is no
|
|
195
196
|
credential-free public index to search. With no credential, every
|
|
196
197
|
command that talks to the API prints the login instruction and exits
|
package/dist/client.js
CHANGED
|
@@ -95,7 +95,8 @@ export class AlmytyClient {
|
|
|
95
95
|
};
|
|
96
96
|
}
|
|
97
97
|
async listGateways() {
|
|
98
|
-
|
|
98
|
+
// Gateways are MCP, UTCP and Skills; an agent's channels are not listed.
|
|
99
|
+
const data = await this.request('/gateways?kind=tool');
|
|
99
100
|
const gateways = data?.data?.gateways || data?.data?.data || data?.data || [];
|
|
100
101
|
return (Array.isArray(gateways) ? gateways : []).map((gw) => ({
|
|
101
102
|
id: gw.id,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@almyty/skills",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.3",
|
|
4
4
|
"publishConfig": {
|
|
5
5
|
"access": "public"
|
|
6
6
|
},
|
|
@@ -35,7 +35,7 @@
|
|
|
35
35
|
"author": "almyty",
|
|
36
36
|
"license": "Apache-2.0",
|
|
37
37
|
"dependencies": {
|
|
38
|
-
"@almyty/client": "^1.5.
|
|
38
|
+
"@almyty/client": "^1.5.2",
|
|
39
39
|
"@clack/prompts": "^1.2.0"
|
|
40
40
|
},
|
|
41
41
|
"devDependencies": {
|