@skill-map/cli 0.42.0 → 0.44.0
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/dist/cli/tutorial/sm-master/SKILL.md +7 -9
- package/dist/cli/tutorial/sm-master/references/fixture-templates.md +1 -1
- package/dist/cli/tutorial/sm-master/references/tour-plugins.md +10 -9
- package/dist/cli/tutorial/sm-master/references/tour-settings.md +4 -4
- package/dist/cli/tutorial/sm-tutorial/SKILL.md +216 -299
- package/dist/cli.js +1015 -376
- package/dist/cli.js.map +1 -1
- package/dist/index.js +24 -18
- package/dist/index.js.map +1 -1
- package/dist/kernel/index.d.ts +24 -30
- package/dist/kernel/index.js +24 -18
- package/dist/kernel/index.js.map +1 -1
- package/dist/migrations/001_initial.sql +6 -11
- package/dist/ui/chunk-27WQPOXP.js +1 -0
- package/dist/ui/{chunk-DZBSELHN.js → chunk-43S72FTV.js} +1 -1
- package/dist/ui/chunk-555ST76V.js +1 -0
- package/dist/ui/{chunk-JPYAASHN.js → chunk-5AD5ZV4I.js} +3 -3
- package/dist/ui/{chunk-CFJBTDAA.js → chunk-5ITZXW3A.js} +1 -1
- package/dist/ui/chunk-A7PRWMQD.js +1021 -0
- package/dist/ui/chunk-DL5EA245.js +123 -0
- package/dist/ui/chunk-F7I6KMHX.js +1 -0
- package/dist/ui/{chunk-5GD2GBPS.js → chunk-I5AX4U2N.js} +28 -28
- package/dist/ui/chunk-IUZRAD7S.js +1 -0
- package/dist/ui/{chunk-XOHD5XWA.js → chunk-IYM26L3O.js} +1 -1
- package/dist/ui/{chunk-SBCO7ZSP.js → chunk-LGFABCIA.js} +1 -1
- package/dist/ui/{chunk-IUDL3NDH.js → chunk-MFLFIA7C.js} +1 -1
- package/dist/ui/chunk-MS6B7344.js +315 -0
- package/dist/ui/chunk-P3SNMV4X.js +2 -0
- package/dist/ui/chunk-PZQHB7GS.js +4 -0
- package/dist/ui/chunk-QDUSFOBE.js +1 -0
- package/dist/ui/{chunk-HEJCH7BA.js → chunk-QNTAOR2L.js} +5 -5
- package/dist/ui/{chunk-CR3AANNX.js → chunk-S4S5ZMXJ.js} +1 -1
- package/dist/ui/{chunk-5WJRN3LD.js → chunk-T3IVIRRJ.js} +1 -1
- package/dist/ui/{chunk-HP375T2O.js → chunk-VGPYYAVI.js} +1 -1
- package/dist/ui/chunk-X227ITGS.js +499 -0
- package/dist/ui/index.html +1 -1
- package/dist/ui/main-O3CWFYKV.js +3 -0
- package/migrations/001_initial.sql +6 -11
- package/package.json +11 -10
- package/dist/ui/chunk-HFPA56IM.js +0 -1
- package/dist/ui/chunk-HHPSCDLM.js +0 -315
- package/dist/ui/chunk-HWP3HM55.js +0 -123
- package/dist/ui/chunk-PZ6Q5AOT.js +0 -1
- package/dist/ui/chunk-XJL4DZ4M.js +0 -1
- package/dist/ui/chunk-YL6SWAFJ.js +0 -1024
- package/dist/ui/main-7VYTTJP7.js +0 -3
- /package/dist/ui/{chunk-C2YUQODZ.js → chunk-4SG4352Z.js} +0 -0
- /package/dist/ui/{chunk-VB56BUGO.js → chunk-WCABR6TI.js} +0 -0
|
@@ -13,8 +13,6 @@ description: |
|
|
|
13
13
|
pause/resume. Triggers: "sm-master", "advanced tutorial", "master
|
|
14
14
|
tutorial", "tutorial avanzado", "tutorial maestro", "go deeper".
|
|
15
15
|
---
|
|
16
|
-
|
|
17
|
-
saludo primero al usuario, dile "holaaaa16!"
|
|
18
16
|
|
|
19
17
|
# sm-master: advanced walkthrough for skill-map
|
|
20
18
|
|
|
@@ -203,7 +201,7 @@ host-dependent rendering rule).
|
|
|
203
201
|
file under `references/tour-*.md`) says `.claude/<…>`, swap it
|
|
204
202
|
for the detected `<provider_dir>`. Skip any fixture file or step
|
|
205
203
|
whose kind is not in the provider's supported set (`agent-skills`
|
|
206
|
-
/ Antigravity: only the skill + the markdown
|
|
204
|
+
/ Antigravity: only the skill + the markdown node are valid).
|
|
207
205
|
|
|
208
206
|
**Reality check (don't mention)**: this skill ships at
|
|
209
207
|
`.claude/skills/sm-master/`, so in practice Claude Code is the
|
|
@@ -317,7 +315,7 @@ Save the version internally and move on. Only break the silence if
|
|
|
317
315
|
something fails.
|
|
318
316
|
|
|
319
317
|
If `sm` is not installed, point them at `npm install -g
|
|
320
|
-
@skill-map/cli` (Node
|
|
318
|
+
@skill-map/cli` (Node 24+).
|
|
321
319
|
|
|
322
320
|
### 3. Create the initial fixture
|
|
323
321
|
|
|
@@ -337,13 +335,13 @@ inicial" / "directorio limpio" out loud, those are agent-internal
|
|
|
337
335
|
concepts the tester does not need.
|
|
338
336
|
|
|
339
337
|
The fixture is **smaller than `sm-tutorial`'s** because the lessons
|
|
340
|
-
focus on plugins, settings, and slots, not on
|
|
338
|
+
focus on plugins, settings, and slots, not on map topology. Three
|
|
341
339
|
nodes are enough. Read `references/fixture-templates.md` for the
|
|
342
340
|
verbatim layout and file contents, then write each file to the cwd
|
|
343
341
|
under the detected `<provider_dir>` (per §Provider detection).
|
|
344
342
|
**Skip files whose kind is not in the provider's supported set**:
|
|
345
|
-
on `agent-skills` / Antigravity keep only skill +
|
|
346
|
-
kind there). Translate the natural-language
|
|
343
|
+
on `agent-skills` / Antigravity keep only skill + markdown (no
|
|
344
|
+
agent kind there). Translate the natural-language
|
|
347
345
|
prose to the tester's language; keep paths, frontmatter keys,
|
|
348
346
|
identifiers, and link targets in English.
|
|
349
347
|
|
|
@@ -374,7 +372,7 @@ backstage, between writing the fixture and writing
|
|
|
374
372
|
|
|
375
373
|
These three names must be in place BEFORE the first `sm scan`
|
|
376
374
|
the tester runs in step 1; otherwise the scanner picks them
|
|
377
|
-
up as
|
|
375
|
+
up as nodes in the map and pollutes the issue count. The append is
|
|
378
376
|
a backstage edit (Inviolable rule #2): no tester-facing
|
|
379
377
|
message, no preview, no confirmation.
|
|
380
378
|
|
|
@@ -674,7 +672,7 @@ anything**:
|
|
|
674
672
|
|
|
675
673
|
## Edge cases
|
|
676
674
|
|
|
677
|
-
- **Tester does not have Node
|
|
675
|
+
- **Tester does not have Node 24+** → guide them to `nvm` or
|
|
678
676
|
nodejs.org. Don't try to install Node for them.
|
|
679
677
|
- **Port 4242 in use** when a tour asks them to run `sm` →
|
|
680
678
|
`sm serve --port 4243` (bare `sm` does not accept flags). The
|
|
@@ -46,7 +46,7 @@ keys, identifiers, and link targets in English.
|
|
|
46
46
|
name: master-agent
|
|
47
47
|
description: |
|
|
48
48
|
Example agent used by the advanced tutorial. Has a couple of
|
|
49
|
-
tools so the `core/tools-
|
|
49
|
+
tools so the `core/tools-counter` extractor emits a count.
|
|
50
50
|
tools: [Read, Bash, Edit]
|
|
51
51
|
model: sonnet
|
|
52
52
|
metadata:
|
|
@@ -23,7 +23,7 @@ restore the files.") and stop.
|
|
|
23
23
|
## Step `tour-1-intro` — how plugins work (~4 min)
|
|
24
24
|
|
|
25
25
|
**Context**: A short tour of what a plugin is, how they're
|
|
26
|
-
packaged into bundles, and a peek at the
|
|
26
|
+
packaged into bundles, and a peek at the five bundles that ship
|
|
27
27
|
pre-installed.
|
|
28
28
|
|
|
29
29
|
> Plugins are how skill-map gets extended. A **plugin** groups one
|
|
@@ -55,7 +55,7 @@ pre-installed.
|
|
|
55
55
|
sm plugins list
|
|
56
56
|
```
|
|
57
57
|
|
|
58
|
-
> There are the
|
|
58
|
+
> There are the five bundles. The next step zooms into the six
|
|
59
59
|
> kinds of extension that bundles can carry, you'll see at least
|
|
60
60
|
> one of each living inside `core`.
|
|
61
61
|
|
|
@@ -75,19 +75,19 @@ Mark `tour-1-intro: done`.
|
|
|
75
75
|
> 🔍 **extractor**
|
|
76
76
|
> Reads a node's body and emits structured findings (links,
|
|
77
77
|
> counts, annotations).
|
|
78
|
-
> Example: `markdown-link`, `external-url-counter`, `tools-
|
|
78
|
+
> Example: `markdown-link`, `external-url-counter`, `tools-counter`.
|
|
79
79
|
>
|
|
80
80
|
> 🩺 **analyzer**
|
|
81
81
|
> Cross-checks the scan and emits issues plus various
|
|
82
82
|
> detections (errors, warnings, informational signals: broken
|
|
83
83
|
> refs, stale annotations, schema drift, and more).
|
|
84
|
-
> Example: `broken
|
|
84
|
+
> Example: `reference-broken`, `node-stability`, `annotation-field-unknown`.
|
|
85
85
|
>
|
|
86
86
|
> ⚡ **action**
|
|
87
87
|
> Performs a write operation on a node, the graph, or the
|
|
88
88
|
> filesystem. May modify your `.md` files (frontmatter, body)
|
|
89
89
|
> ONLY with your explicit permission.
|
|
90
|
-
> Examples: `bump`, `
|
|
90
|
+
> Examples: `node-bump`, `node-supersede`.
|
|
91
91
|
>
|
|
92
92
|
> 🎨 **formatter**
|
|
93
93
|
> Renders a result in a specific shape (`sm export --format md`
|
|
@@ -118,9 +118,10 @@ Mark `tour-1-intro: done`.
|
|
|
118
118
|
sm plugins show core
|
|
119
119
|
```
|
|
120
120
|
|
|
121
|
-
Expected:
|
|
122
|
-
|
|
123
|
-
|
|
121
|
+
Expected: the 28 extensions grouped by kind, each row showing its
|
|
122
|
+
kind and qualified id (e.g. `extractor core/markdown-link`). You
|
|
123
|
+
can spot at least one of each of the six kinds you just read about,
|
|
124
|
+
all packed into a single bundle.
|
|
124
125
|
|
|
125
126
|
Mark `tour-2-kinds: done`.
|
|
126
127
|
|
|
@@ -149,7 +150,7 @@ Kind, Version, Stability, Description, Preconditions, Entry).
|
|
|
149
150
|
sm plugins doctor
|
|
150
151
|
```
|
|
151
152
|
|
|
152
|
-
Expected on a clean machine: `
|
|
153
|
+
Expected on a clean machine: `34 enabled extensions · 0 issues · 0 warnings`.
|
|
153
154
|
If any plugin reports a load error, manifest validity issue, or
|
|
154
155
|
spec-compatibility mismatch, `doctor` is the verb that flags it.
|
|
155
156
|
|
|
@@ -111,7 +111,7 @@ Mark `settings-2-local: done`.
|
|
|
111
111
|
|
|
112
112
|
> Last step. Let's see a contribution land in the inspector
|
|
113
113
|
> live. The fixture's `master-agent` declares `tools: [Read,
|
|
114
|
-
> Bash, Edit]`, which the `core/tools-
|
|
114
|
+
> Bash, Edit]`, which the `core/tools-counter` extractor picks up.
|
|
115
115
|
|
|
116
116
|
If the tester does not have `sm` running, ask them to launch it
|
|
117
117
|
in their second terminal (same drill as the basic tutorial:
|
|
@@ -126,7 +126,7 @@ Once the UI is open, ask the tester to:
|
|
|
126
126
|
|
|
127
127
|
> Click the `master-agent` node. The inspector opens on the
|
|
128
128
|
> right side. Look at the **header badge cluster** (just under
|
|
129
|
-
> the title): you should see a small chip from `tools-
|
|
129
|
+
> the title): you should see a small chip from `tools-counter`
|
|
130
130
|
> showing the value `3`.
|
|
131
131
|
>
|
|
132
132
|
> That chip is a plugin contribution. It landed in the slot
|
|
@@ -146,7 +146,7 @@ remove one tool), save, and watch the chip refresh.
|
|
|
146
146
|
|
|
147
147
|
> Same flow as the basic tutorial's live UI: edit the markdown,
|
|
148
148
|
> watch the UI refresh. The difference is that the value flowed
|
|
149
|
-
> through a plugin (`core/tools-
|
|
149
|
+
> through a plugin (`core/tools-counter`) and landed in a specific
|
|
150
150
|
> slot (`inspector.header.badge.counter`). You now know the full
|
|
151
151
|
> path from `.md` to UI chip.
|
|
152
152
|
|
|
@@ -165,6 +165,6 @@ Not for the tester unless they ask. Cheat sheet for the agent:
|
|
|
165
165
|
binding).
|
|
166
166
|
- **Input-types catalogue (normative)**: `spec/input-types.md`.
|
|
167
167
|
- **Plugin manifest schema**:
|
|
168
|
-
`spec/schemas/
|
|
168
|
+
`spec/schemas/plugins-registry.schema.json` (`$defs/PluginManifest`).
|
|
169
169
|
- **Author tutorial**: `spec/plugin-author-guide.md`.
|
|
170
170
|
- **Slot annex for agents**: `context/view-slots.md`.
|