@skill-map/cli 0.67.0 → 0.68.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/dist/cli/tutorial/sm-tutorial/SKILL.md +30 -23
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/agents-hub/providers/agent-skills/en/agents-hub.md +2 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/agents-hub/providers/agent-skills/es/agents-hub.md +2 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/content-editor-style/providers/agent-skills/en/content-editor-style.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/content-editor-style/providers/agent-skills/es/content-editor-style.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/en/todo-bullet-guideline.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/en/todo-bullet-guideline2.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/en/todo-bullet-skill.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/es/todo-bullet-guideline.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/es/todo-bullet-guideline2.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/es/todo-bullet-skill.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/manifest.json +9 -4
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/providers/agent-skills/en/__PROVIDER__/skills/publish/SKILL.md +15 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/providers/agent-skills/es/__PROVIDER__/skills/publish/SKILL.md +16 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/providers/codex/en/__PROVIDER__/skills/publish/SKILL.md +15 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/providers/codex/es/__PROVIDER__/skills/publish/SKILL.md +16 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/providers/agent-skills/en/__PROVIDER__/skills/master-agent/SKILL.md +13 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/providers/agent-skills/es/__PROVIDER__/skills/master-agent/SKILL.md +14 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/providers/codex/en/.codex/agents/master-agent.toml +10 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/providers/codex/es/.codex/agents/master-agent.toml +10 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/en/AGENTS.md +7 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/en/__PROVIDER__/skills/content-editor/SKILL.md +20 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/es/AGENTS.md +7 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/es/__PROVIDER__/skills/content-editor/SKILL.md +20 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/shared/CLAUDE.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/codex/en/.codex/agents/content-editor.toml +19 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/codex/es/.codex/agents/content-editor.toml +19 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/providers/codex/en/.codex/agents/demo-agent.toml +13 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/providers/codex/en/__PROVIDER__/skills/demo-command/SKILL.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/providers/codex/es/.codex/agents/demo-agent.toml +13 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/providers/codex/es/__PROVIDER__/skills/demo-command/SKILL.md +12 -0
- package/dist/cli/tutorial/sm-tutorial/references/_core.md +102 -49
- package/dist/cli/tutorial/sm-tutorial/references/_manifest.json +168 -20
- package/dist/cli/tutorial/sm-tutorial/references/_manifest.yml +85 -19
- package/dist/cli/tutorial/sm-tutorial/references/fixtures.md +6 -7
- package/dist/cli/tutorial/sm-tutorial/references/part-authoring.md +2 -2
- package/dist/cli/tutorial/sm-tutorial/references/part-basic-daily.md +241 -0
- package/dist/cli/tutorial/sm-tutorial/references/part-basic-fundamentals.md +351 -0
- package/dist/cli/tutorial/sm-tutorial/references/part-basic-kickoff.md +285 -0
- package/dist/cli/tutorial/sm-tutorial/references/part-cli.md +1 -1
- package/dist/cli/tutorial/sm-tutorial/references/part-daily-loop.md +62 -99
- package/dist/cli/tutorial/sm-tutorial/references/part-fundamentals.md +35 -34
- package/dist/cli/tutorial/sm-tutorial/references/part-mcp.md +3 -6
- package/dist/cli/tutorial/sm-tutorial/references/part-plugins.md +1 -1
- package/dist/cli/tutorial/sm-tutorial/references/part-project-kickoff.md +198 -26
- package/dist/cli/tutorial/sm-tutorial/references/part-settings.md +19 -15
- package/dist/cli/tutorial/sm-tutorial/scripts/fixtures.js +85 -22
- package/dist/cli/tutorial/sm-tutorial/scripts/lib/paths.js +74 -4
- package/dist/cli/tutorial/sm-tutorial/scripts/state.js +22 -6
- package/dist/cli.js +409 -168
- package/dist/conformance/index.js +42 -2
- package/dist/index.js +43 -30
- package/dist/kernel/index.d.ts +28 -5
- package/dist/kernel/index.js +43 -30
- package/dist/ui/chunk-22EQLC23.js +1845 -0
- package/dist/ui/chunk-3ANNEMV4.js +499 -0
- package/dist/ui/{chunk-5BJGO7GH.js → chunk-3U4QZKU2.js} +4 -4
- package/dist/ui/chunk-3ZAHOYQ7.js +1 -0
- package/dist/ui/{chunk-56CBK7LB.js → chunk-6FGV5O5J.js} +1 -1
- package/dist/ui/chunk-7WMT2LX4.js +1 -0
- package/dist/ui/{chunk-276RLZR4.js → chunk-BSIR3ADF.js} +14 -14
- package/dist/ui/{chunk-FC22ZJQZ.js → chunk-CG25RHMO.js} +1 -1
- package/dist/ui/chunk-EFSC6SOL.js +3 -0
- package/dist/ui/chunk-EJVWTBMV.js +4 -0
- package/dist/ui/chunk-EZI3BXQN.js +1 -0
- package/dist/ui/{chunk-JZ2YF7EL.js → chunk-GUPPOK7U.js} +8 -8
- package/dist/ui/{chunk-CJURGJTN.js → chunk-HLALESGR.js} +1 -1
- package/dist/ui/chunk-I3I4KHR5.js +2 -0
- package/dist/ui/{chunk-BOVJVOLH.js → chunk-I6ED2OW7.js} +1 -1
- package/dist/ui/chunk-JKPG5PO7.js +375 -0
- package/dist/ui/chunk-K3ZRQNN5.js +2 -0
- package/dist/ui/chunk-KHDWXSGR.js +1 -0
- package/dist/ui/{chunk-HEK4PH5A.js → chunk-KMHXNOFZ.js} +1 -1
- package/dist/ui/chunk-KWT7E2RJ.js +16 -0
- package/dist/ui/{chunk-WHZVGOS3.js → chunk-MQSU6EFZ.js} +1 -1
- package/dist/ui/{chunk-43S72FTV.js → chunk-OGEE252A.js} +1 -1
- package/dist/ui/{chunk-J4J42HJ4.js → chunk-PU5OP5RN.js} +1 -1
- package/dist/ui/{chunk-UTRZTB6V.js → chunk-QVG7J2MP.js} +1 -1
- package/dist/ui/chunk-TLMV4LOQ.js +3 -0
- package/dist/ui/chunk-TQBXK5JN.js +1 -0
- package/dist/ui/chunk-Z7SOKILO.js +2 -0
- package/dist/ui/{chunk-WCABR6TI.js → chunk-ZRJ5ZCFR.js} +1 -1
- package/dist/ui/index.html +2 -2
- package/dist/ui/main-R7BIU4HU.js +4 -0
- package/dist/ui/styles-VEGETYWD.css +1 -0
- package/package.json +17 -18
- package/dist/cli/tutorial/sm-tutorial/references/part-connect-harness.md +0 -173
- package/dist/ui/chunk-34ZZDYNQ.js +0 -1
- package/dist/ui/chunk-444BFYGR.js +0 -3
- package/dist/ui/chunk-44VNNUSQ.js +0 -2
- package/dist/ui/chunk-4SG4352Z.js +0 -7
- package/dist/ui/chunk-5ITZXW3A.js +0 -1
- package/dist/ui/chunk-7ANZW2OI.js +0 -499
- package/dist/ui/chunk-BJ6X6WBO.js +0 -4
- package/dist/ui/chunk-CZSLV6YD.js +0 -1
- package/dist/ui/chunk-DLYJHLJX.js +0 -2
- package/dist/ui/chunk-LGFABCIA.js +0 -16
- package/dist/ui/chunk-LPDD2DHE.js +0 -369
- package/dist/ui/chunk-P3SNMV4X.js +0 -2
- package/dist/ui/chunk-S4S5ZMXJ.js +0 -3
- package/dist/ui/chunk-VHEFRMK3.js +0 -1
- package/dist/ui/chunk-X6TRIDBI.js +0 -1845
- package/dist/ui/main-V77F2KZX.js +0 -4
- package/dist/ui/styles-I4ULXD3V.css +0 -1
- /package/dist/ui/{chunk-Y2Z26SRI.js → chunk-5RNLC6V4.js} +0 -0
|
@@ -44,7 +44,7 @@ prefix when a part spans several files: `settings-*` →
|
|
|
44
44
|
> For the tester this is a single guided session, never a course
|
|
45
45
|
> catalogue. Refer to a chapter by its tester-facing `section.chapter`
|
|
46
46
|
> number plus its friendly title (`_core.md` §Numbering); never expose
|
|
47
|
-
> the internal `order` index ("Part
|
|
47
|
+
> the internal `order` index ("Part 3", off by one from the menu), a
|
|
48
48
|
> raw "chapter id", or tour jargon ("the settings tour").
|
|
49
49
|
|
|
50
50
|
## Pre-flight (run once, silent on success)
|
|
@@ -214,9 +214,10 @@ for the data layout and the verb surface.
|
|
|
214
214
|
|
|
215
215
|
- **Fixture sets** (laid by `fixtures.js lay <set>` / `seed <snap>`):
|
|
216
216
|
`universal` (the two files above), `prologue` (the Part 0 demo),
|
|
217
|
-
`portfolio` (Part 1 boot + harness members), `harness` (the
|
|
218
|
-
|
|
219
|
-
reference-paths). The script resolves the
|
|
217
|
+
`portfolio` (Part 1 boot + harness members), `harness` (the connect
|
|
218
|
+
chapters, now folded into Part 1), `master` (Part 3 Extend),
|
|
219
|
+
`cli-external` (Part 4 reference-paths). The script resolves the
|
|
220
|
+
`__PROVIDER__` token,
|
|
220
221
|
skips kinds the provider does not claim, and reports `nodeCount` +
|
|
221
222
|
`skipped` for you to narrate.
|
|
222
223
|
- **Footprints** (the on-disk reach of each fixture, including files a
|
|
@@ -242,12 +243,18 @@ All commands below are backstage (silent); fill `<provider>` and
|
|
|
242
243
|
`<lang>` from `tutorial.{provider,lang}`. The fixture scripts resolve
|
|
243
244
|
the `__PROVIDER__` token and skip kinds the provider does not claim.
|
|
244
245
|
|
|
245
|
-
- **`taught-init`** (Part 0 `fundamentals`
|
|
246
|
-
fixture progressively, so on entry
|
|
247
|
-
before the tester's `sm init` in the
|
|
246
|
+
- **`taught-init`** (Part 0 `fundamentals` rich / `basic-fundamentals`
|
|
247
|
+
basic): the prologue reveals its fixture progressively, so on entry
|
|
248
|
+
lay ONLY the boot node, just before the tester's `sm init` in the
|
|
249
|
+
`init` chapter. The boot node is the lens's first authored kind, an
|
|
250
|
+
`agent` on the rich track, a `skill` on the basic track (where the
|
|
251
|
+
agent kind folds away):
|
|
248
252
|
|
|
249
253
|
```bash
|
|
254
|
+
# rich track (claude / codex)
|
|
250
255
|
node .claude/skills/sm-tutorial/scripts/fixtures.js lay prologue --only "__PROVIDER__/agents/demo-agent.md" --provider <provider> --lang <lang>
|
|
256
|
+
# basic track (agent-skills / antigravity)
|
|
257
|
+
node .claude/skills/sm-tutorial/scripts/fixtures.js lay prologue --only "__PROVIDER__/skills/demo-skill/SKILL.md" --provider <provider> --lang <lang>
|
|
251
258
|
```
|
|
252
259
|
|
|
253
260
|
The universal `.skillmapignore` is already on disk, so the first
|
|
@@ -271,7 +278,7 @@ the `__PROVIDER__` token and skip kinds the provider does not claim.
|
|
|
271
278
|
parts use `preflight: seed`; `portfolio-init` is Part 1's flavour,
|
|
272
279
|
handling the Part 0 to Part 1 transition.)
|
|
273
280
|
|
|
274
|
-
- **`backstage-init`** (Part
|
|
281
|
+
- **`backstage-init`** (Part 3 `extend`): teaches plugins on its own
|
|
275
282
|
**master fixture**. On entry, silently:
|
|
276
283
|
1. Clear whatever prior fixture is present (each a no-op when absent),
|
|
277
284
|
then drop the DB: `fixtures.js clear prologue --provider <provider>`,
|
|
@@ -279,10 +286,10 @@ the `__PROVIDER__` token and skip kinds the provider does not claim.
|
|
|
279
286
|
2. `sm init --no-scan` (the pre-flight `.skillmapignore` stays).
|
|
280
287
|
3. `fixtures.js lay master --provider <provider> --lang <lang>`.
|
|
281
288
|
|
|
282
|
-
On a Part
|
|
289
|
+
On a Part 3 re-entry where the master fixture is already in place the
|
|
283
290
|
clears + lay are idempotent; just `sm scan`.
|
|
284
291
|
|
|
285
|
-
- **`seed: prologue-built`** (Part
|
|
292
|
+
- **`seed: prologue-built`** (Part 4 `cli`): reads the Part 0 demo
|
|
286
293
|
fixture, NOT the portfolio. On entry:
|
|
287
294
|
1. If the portfolio is present, clear it + drop the DB:
|
|
288
295
|
`fixtures.js clear portfolio --provider <provider>`, `rm -rf .skill-map`.
|
|
@@ -295,20 +302,20 @@ the `__PROVIDER__` token and skip kinds the provider does not claim.
|
|
|
295
302
|
3. `sm init` (single `.claude/` marker, no lens prompt), then `sm scan`.
|
|
296
303
|
If `.skill-map/` already exists, skip the init and just `sm scan`.
|
|
297
304
|
|
|
298
|
-
- **`seed`** (campaign
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
**fast-forward, silently**:
|
|
305
|
+
- **`seed`** (campaign part `daily-loop`): builds on the accumulating
|
|
306
|
+
portfolio, but the tester may have jumped here. Run `state.js status`;
|
|
307
|
+
if every predecessor up the `prereq` chain is `done`, the harness is
|
|
308
|
+
already on disk, just `sm scan`. Otherwise **fast-forward, silently**:
|
|
303
309
|
1. If the prologue ran first here, `fixtures.js clear prologue --provider <provider>`.
|
|
304
|
-
2. Seed: `fixtures.js seed
|
|
305
|
-
(
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
`sm scan`. (If `.skill-map/` already exists, just
|
|
310
|
+
2. Seed: `fixtures.js seed harness-connected --provider <provider> --lang <lang>`
|
|
311
|
+
(the wired harness that `daily-loop` builds on).
|
|
312
|
+
3. Provision the lens: the seeded portfolio carries the scaffold
|
|
313
|
+
marker (`.claude/` on the rich track, `.agents/` on the basic
|
|
314
|
+
track), so a plain `sm init` resolves the matching lens with no
|
|
315
|
+
prompt. (The root `AGENTS.md` is the vendor-neutral agents.md file,
|
|
316
|
+
NOT a marker, so it never forces an ambiguous prompt.) Run `sm
|
|
317
|
+
init`, then `sm scan`. (If `.skill-map/` already exists, just
|
|
318
|
+
`sm scan`.)
|
|
312
319
|
4. Mark the skipped predecessors: `state.js set-part <predecessor> skipped`
|
|
313
320
|
for each (they stay in the menu). Then emit exactly ONE
|
|
314
321
|
tester-facing line:
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
Every page follows the [style guide](../../../docs/STYLE.md).
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
Cada página sigue la [guía de estilo](../../../docs/STYLE.md).
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
- [ ] Follow the [demo-guideline](demo-guideline) when the conventions change.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
- [ ] Follow the [demo-guideline2](demo-guideline2.md) for the rest.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
- [ ] See the [demo-skill](../.agents/skills/demo-skill/SKILL.md) for the steps.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
- [ ] Seguí la [demo-guideline](demo-guideline) cuando cambien las convenciones.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
- [ ] Seguí la [demo-guideline2](demo-guideline2.md) para el resto.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
- [ ] Mirá la [demo-skill](../.agents/skills/demo-skill/SKILL.md) para los pasos.
|
|
@@ -7,8 +7,10 @@
|
|
|
7
7
|
"footprints": {
|
|
8
8
|
"prologue": [
|
|
9
9
|
"__PROVIDER__/agents/demo-agent.md",
|
|
10
|
+
".codex/agents/demo-agent.toml",
|
|
10
11
|
"__PROVIDER__/skills/demo-skill",
|
|
11
12
|
"__PROVIDER__/commands/demo-command.md",
|
|
13
|
+
"__PROVIDER__/skills/demo-command",
|
|
12
14
|
"notes/todo.md",
|
|
13
15
|
"notes/demo-guideline.md",
|
|
14
16
|
"notes/demo-guideline2.md",
|
|
@@ -28,12 +30,18 @@
|
|
|
28
30
|
"docs/DEPLOY.md",
|
|
29
31
|
"docs/DEPLOYMENT.md",
|
|
30
32
|
"__PROVIDER__/agents/content-editor.md",
|
|
33
|
+
".codex/agents/content-editor.toml",
|
|
34
|
+
"__PROVIDER__/skills/content-editor",
|
|
31
35
|
"__PROVIDER__/skills/check-links",
|
|
32
36
|
"__PROVIDER__/commands/publish.md",
|
|
33
|
-
"__PROVIDER__/
|
|
37
|
+
"__PROVIDER__/skills/publish",
|
|
38
|
+
"__PROVIDER__/commands/new-page.md",
|
|
39
|
+
"__PROVIDER__/skills/new-page"
|
|
34
40
|
],
|
|
35
41
|
"master": [
|
|
36
42
|
"__PROVIDER__/agents/master-agent.md",
|
|
43
|
+
".codex/agents/master-agent.toml",
|
|
44
|
+
"__PROVIDER__/skills/master-agent",
|
|
37
45
|
"__PROVIDER__/skills/master-skill",
|
|
38
46
|
"notes/ideas.md"
|
|
39
47
|
],
|
|
@@ -74,9 +82,6 @@
|
|
|
74
82
|
"edits": ["todo-connectors"],
|
|
75
83
|
"drop": ["notes/private-credentials.md"]
|
|
76
84
|
},
|
|
77
|
-
"harness-built": {
|
|
78
|
-
"lay": ["portfolio"]
|
|
79
|
-
},
|
|
80
85
|
"harness-connected": {
|
|
81
86
|
"lay": ["portfolio", "harness"],
|
|
82
87
|
"edits": ["agents-hub", "content-editor-style"]
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: publish
|
|
3
|
+
description: |
|
|
4
|
+
Publishes the portfolio: runs the link check, hands off to the
|
|
5
|
+
content editor for any last fixes, then follows the deploy runbook.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# publish
|
|
9
|
+
|
|
10
|
+
The one skill you run when the site is ready to go out.
|
|
11
|
+
|
|
12
|
+
## Steps
|
|
13
|
+
1. Run the [check-links](../check-links/SKILL.md) skill on the pages in public/. If it reports broken links, stop and fix them first.
|
|
14
|
+
2. If a page needs a content fix, hand the change to [content-editor](../content-editor/SKILL.md).
|
|
15
|
+
3. Follow the [deploy runbook](../../../docs/DEPLOY.md): regenerate pages, run the link check, start the server.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: publish
|
|
3
|
+
description: |
|
|
4
|
+
Publica el portfolio: corre el chequeo de enlaces, le pasa al
|
|
5
|
+
content editor los últimos arreglos, y luego sigue el runbook de
|
|
6
|
+
despliegue.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# publish
|
|
10
|
+
|
|
11
|
+
La única skill que corres cuando el sitio está listo para salir.
|
|
12
|
+
|
|
13
|
+
## Pasos
|
|
14
|
+
1. Corre la skill [check-links](../check-links/SKILL.md) sobre las páginas en public/. Si reporta enlaces rotos, frena y arréglalos primero.
|
|
15
|
+
2. Si una página necesita un arreglo de contenido, pasale el cambio a [content-editor](../content-editor/SKILL.md).
|
|
16
|
+
3. Sigue el [runbook de despliegue](../../../docs/DEPLOY.md): regenera las páginas, corre el chequeo de enlaces, inicia el servidor.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: publish
|
|
3
|
+
description: |
|
|
4
|
+
Publishes the portfolio: runs the link check, hands off to the
|
|
5
|
+
content editor for any last fixes, then follows the deploy runbook.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# publish
|
|
9
|
+
|
|
10
|
+
The one skill you run when the site is ready to go out.
|
|
11
|
+
|
|
12
|
+
## Steps
|
|
13
|
+
1. Run /check-links on the pages in public/. If it reports broken links, stop and fix them first.
|
|
14
|
+
2. If a page needs a content fix, brief @content-editor with the change.
|
|
15
|
+
3. Follow the [deploy runbook](../../../docs/DEPLOY.md): regenerate pages, run the link check, start the server.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: publish
|
|
3
|
+
description: |
|
|
4
|
+
Publica el portfolio: corre el chequeo de enlaces, le pasa al
|
|
5
|
+
content editor los últimos arreglos, y luego sigue el runbook de
|
|
6
|
+
despliegue.
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# publish
|
|
10
|
+
|
|
11
|
+
La única skill que corres cuando el sitio está listo para salir.
|
|
12
|
+
|
|
13
|
+
## Pasos
|
|
14
|
+
1. Corre /check-links sobre las páginas en public/. Si reporta enlaces rotos, frena y arréglalos primero.
|
|
15
|
+
2. Si una página necesita un arreglo de contenido, dale el cambio a @content-editor.
|
|
16
|
+
3. Sigue el [runbook de despliegue](../../../docs/DEPLOY.md): regenera las páginas, corre el chequeo de enlaces, inicia el servidor.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: master-agent
|
|
3
|
+
description: |
|
|
4
|
+
Example skill used by the advanced tutorial. Declares a couple of
|
|
5
|
+
tools so the `core/tools-counter` extractor emits a count.
|
|
6
|
+
allowed-tools: Read Bash Edit
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# master-agent
|
|
10
|
+
|
|
11
|
+
Walks the master-skill outputs and reports findings. Used as the
|
|
12
|
+
target node when we exercise extractors, analyzers, and the
|
|
13
|
+
plugin-authoring flow.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: master-agent
|
|
3
|
+
description: |
|
|
4
|
+
Skill de ejemplo que usa el tutorial avanzado. Declara un par de
|
|
5
|
+
herramientas para que el extractor `core/tools-counter` emita un
|
|
6
|
+
conteo.
|
|
7
|
+
allowed-tools: Read Bash Edit
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# master-agent
|
|
11
|
+
|
|
12
|
+
Recorre las salidas de master-skill y reporta hallazgos. Se usa como
|
|
13
|
+
el nodo objetivo cuando ejercitamos extractors, analyzers y el flujo
|
|
14
|
+
de autoría de plugins.
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
name = "master-agent"
|
|
2
|
+
description = "Example agent used by the advanced tutorial. The target node when we exercise extractors, analyzers, and the plugin-authoring flow."
|
|
3
|
+
model = "gpt-5-codex"
|
|
4
|
+
developer_instructions = """
|
|
5
|
+
# master-agent
|
|
6
|
+
|
|
7
|
+
Walks the master-skill outputs and reports findings. Used as the
|
|
8
|
+
target node when we exercise extractors, analyzers, and the
|
|
9
|
+
plugin-authoring flow.
|
|
10
|
+
"""
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
name = "master-agent"
|
|
2
|
+
description = "Agente de ejemplo que usa el tutorial avanzado. Es el nodo objetivo cuando ejercitamos extractors, analyzers y el flujo de autoría de plugins."
|
|
3
|
+
model = "gpt-5-codex"
|
|
4
|
+
developer_instructions = """
|
|
5
|
+
# master-agent
|
|
6
|
+
|
|
7
|
+
Recorre las salidas de master-skill y reporta hallazgos. Se usa como
|
|
8
|
+
el nodo objetivo cuando ejercitamos extractors, analyzers y el flujo
|
|
9
|
+
de autoría de plugins.
|
|
10
|
+
"""
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# Portfolio handbook
|
|
2
|
+
|
|
3
|
+
A small static portfolio site, served by Express (`server.js`). The
|
|
4
|
+
`.agents/skills/` harness maintains it: a content-editor skill writes
|
|
5
|
+
the pages, a check-links skill checks the links, a publish skill ships
|
|
6
|
+
them. The conventions live in the style guide; the deploy steps in the
|
|
7
|
+
deploy runbook.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: content-editor
|
|
3
|
+
description: |
|
|
4
|
+
Writes and edits the portfolio's pages. Reads a brief, follows the
|
|
5
|
+
style guide, and emits the HTML into public/.
|
|
6
|
+
allowed-tools: Read Write
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# content-editor
|
|
10
|
+
|
|
11
|
+
Turns a short brief into a finished portfolio page.
|
|
12
|
+
|
|
13
|
+
## How to write a page
|
|
14
|
+
1. Read the style guide and the shared stylesheet in public/.
|
|
15
|
+
2. Write one HTML file under public/, named after the page (a projects page becomes `public/projects.html`).
|
|
16
|
+
3. Start from `<!doctype html>`, link the stylesheet with `<link rel="stylesheet" href="/style.css">`, and set a `<title>`.
|
|
17
|
+
4. Use one `<h1>`, group sections under `<h2>`, and reuse the shared header, nav, and footer so every page matches.
|
|
18
|
+
5. Add a link back to Home, and link the new page from the home nav.
|
|
19
|
+
|
|
20
|
+
Rules: plain static HTML, no framework, no client JS, one page per file. If a page needs an image, use a free placeholder from https://placekittens.com/ (e.g. `https://placekittens.com/400/300`) so the `<img>` never points at a missing file.
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
# Manual del portfolio
|
|
2
|
+
|
|
3
|
+
Un sitio de portfolio estático y chico, servido por Express
|
|
4
|
+
(`server.js`). El harness en `.agents/skills/` lo mantiene: una skill
|
|
5
|
+
content-editor escribe las páginas, una skill check-links revisa los
|
|
6
|
+
enlaces, una skill publish las publica. Las convenciones viven en la
|
|
7
|
+
guía de estilo; los pasos de despliegue en el runbook de despliegue.
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: content-editor
|
|
3
|
+
description: |
|
|
4
|
+
Escribe y edita las páginas del portfolio. Lee un brief, sigue la
|
|
5
|
+
guía de estilo y emite el HTML en public/.
|
|
6
|
+
allowed-tools: Read Write
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# content-editor
|
|
10
|
+
|
|
11
|
+
Convierte un brief corto en una página de portfolio terminada.
|
|
12
|
+
|
|
13
|
+
## Cómo escribir una página
|
|
14
|
+
1. Lee la guía de estilo y la hoja de estilos compartida en public/.
|
|
15
|
+
2. Escribe un archivo HTML en public/, nombrado según la página (una página de proyectos pasa a ser `public/projects.html`).
|
|
16
|
+
3. Empieza desde `<!doctype html>`, enlaza la hoja de estilos con `<link rel="stylesheet" href="/style.css">` y define un `<title>`.
|
|
17
|
+
4. Usa un solo `<h1>`, agrupa las secciones bajo `<h2>` y reutiliza el header, la nav y el footer compartidos para que todas las páginas coincidan.
|
|
18
|
+
5. Agrega un enlace de vuelta a Home, y enlaza la nueva página desde la nav de inicio.
|
|
19
|
+
|
|
20
|
+
Reglas: HTML estático plano, sin framework, sin JS de cliente, una página por archivo. Si una página necesita una imagen, usa un placeholder gratuito de https://placekittens.com/ (por ejemplo `https://placekittens.com/400/300`) para que el `<img>` nunca apunte a un archivo inexistente.
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
See the [handbook](AGENTS.md).
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
name = "content-editor"
|
|
2
|
+
description = "Writes and edits the portfolio's pages. Reads a brief, follows the style guide, and emits the HTML into public/."
|
|
3
|
+
model = "gpt-5-codex"
|
|
4
|
+
developer_instructions = """
|
|
5
|
+
# content-editor
|
|
6
|
+
|
|
7
|
+
Turns a short brief into a finished portfolio page.
|
|
8
|
+
|
|
9
|
+
## How to write a page
|
|
10
|
+
1. Read the style guide and the shared stylesheet in public/.
|
|
11
|
+
2. Write one HTML file under public/, named after the page (a projects page becomes `public/projects.html`).
|
|
12
|
+
3. Start from `<!doctype html>`, link the stylesheet with `<link rel="stylesheet" href="/style.css">`, and set a `<title>`.
|
|
13
|
+
4. Use one `<h1>`, group sections under `<h2>`, and reuse the shared header, nav, and footer so every page matches.
|
|
14
|
+
5. Add a link back to Home, and link the new page from the home nav.
|
|
15
|
+
|
|
16
|
+
Rules: plain static HTML, no framework, no client JS, one page per file.
|
|
17
|
+
|
|
18
|
+
Every page follows the [style guide](../../docs/STYLE.md).
|
|
19
|
+
"""
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
name = "content-editor"
|
|
2
|
+
description = "Escribe y edita las páginas del portfolio. Lee un brief, sigue la guía de estilo y emite el HTML en public/."
|
|
3
|
+
model = "gpt-5-codex"
|
|
4
|
+
developer_instructions = """
|
|
5
|
+
# content-editor
|
|
6
|
+
|
|
7
|
+
Convierte un brief corto en una página de portfolio terminada.
|
|
8
|
+
|
|
9
|
+
## Cómo escribir una página
|
|
10
|
+
1. Lee la guía de estilo y la hoja de estilos compartida en public/.
|
|
11
|
+
2. Escribe un archivo HTML en public/, nombrado según la página (una página de proyectos pasa a ser `public/projects.html`).
|
|
12
|
+
3. Empieza desde `<!doctype html>`, enlaza la hoja de estilos con `<link rel="stylesheet" href="/style.css">` y define un `<title>`.
|
|
13
|
+
4. Usa un solo `<h1>`, agrupa las secciones bajo `<h2>` y reutiliza el header, la nav y el footer compartidos para que todas las páginas coincidan.
|
|
14
|
+
5. Agrega un enlace de vuelta a Home, y enlaza la nueva página desde la nav de inicio.
|
|
15
|
+
|
|
16
|
+
Reglas: HTML estático plano, sin framework, sin JS de cliente, una página por archivo.
|
|
17
|
+
|
|
18
|
+
Cada página sigue la [guía de estilo](../../docs/STYLE.md).
|
|
19
|
+
"""
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
name = "demo-agent"
|
|
2
|
+
description = "Example agent that handles read and shell tasks. Solo node at boot; gets connected to the rest of the demo fixture during the Live UI step."
|
|
3
|
+
model = "gpt-5-codex"
|
|
4
|
+
developer_instructions = """
|
|
5
|
+
# demo-agent
|
|
6
|
+
|
|
7
|
+
Processes inputs and logs every action to stderr. Will be wired up
|
|
8
|
+
to the rest of the demo fixture later in the walkthrough.
|
|
9
|
+
|
|
10
|
+
Rules:
|
|
11
|
+
- Never run destructive commands without confirmation.
|
|
12
|
+
- Log every action to stderr.
|
|
13
|
+
"""
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: demo-command
|
|
3
|
+
description: |
|
|
4
|
+
Example skill that wraps the demo-skill. On Codex the prologue's
|
|
5
|
+
command-kind node renders as a skill (Codex has no command kind).
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# demo-command
|
|
9
|
+
|
|
10
|
+
Quick entry point for running the demo flow on a target file.
|
|
11
|
+
Connectors land in the next sub-step.
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
name = "demo-agent"
|
|
2
|
+
description = "Agente de ejemplo que maneja tareas de lectura y shell. Nodo solo al arranque; se conecta al resto del fixture demo durante el paso de UI en vivo."
|
|
3
|
+
model = "gpt-5-codex"
|
|
4
|
+
developer_instructions = """
|
|
5
|
+
# demo-agent
|
|
6
|
+
|
|
7
|
+
Procesa entradas y registra cada acción en stderr. Se conectará al
|
|
8
|
+
resto del fixture demo más adelante en el recorrido.
|
|
9
|
+
|
|
10
|
+
Reglas:
|
|
11
|
+
- Nunca corras comandos destructivos sin confirmación.
|
|
12
|
+
- Registrá cada acción en stderr.
|
|
13
|
+
"""
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: demo-command
|
|
3
|
+
description: |
|
|
4
|
+
Skill de ejemplo que envuelve a demo-skill. En Codex el nodo de
|
|
5
|
+
kind command del prólogo se renderiza como skill (Codex no tiene
|
|
6
|
+
kind command).
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# demo-command
|
|
10
|
+
|
|
11
|
+
Punto de entrada rápido para correr el flujo demo sobre un archivo.
|
|
12
|
+
Los conectores llegan en el próximo sub-paso.
|