@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.
Files changed (105) hide show
  1. package/dist/cli/tutorial/sm-tutorial/SKILL.md +30 -23
  2. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/agents-hub/providers/agent-skills/en/agents-hub.md +2 -0
  3. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/agents-hub/providers/agent-skills/es/agents-hub.md +2 -0
  4. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/content-editor-style/providers/agent-skills/en/content-editor-style.md +1 -0
  5. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/content-editor-style/providers/agent-skills/es/content-editor-style.md +1 -0
  6. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/en/todo-bullet-guideline.md +1 -0
  7. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/en/todo-bullet-guideline2.md +1 -0
  8. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/en/todo-bullet-skill.md +1 -0
  9. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/es/todo-bullet-guideline.md +1 -0
  10. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/es/todo-bullet-guideline2.md +1 -0
  11. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/providers/agent-skills/es/todo-bullet-skill.md +1 -0
  12. package/dist/cli/tutorial/sm-tutorial/fixtures-data/manifest.json +9 -4
  13. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/providers/agent-skills/en/__PROVIDER__/skills/publish/SKILL.md +15 -0
  14. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/providers/agent-skills/es/__PROVIDER__/skills/publish/SKILL.md +16 -0
  15. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/providers/codex/en/__PROVIDER__/skills/publish/SKILL.md +15 -0
  16. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/providers/codex/es/__PROVIDER__/skills/publish/SKILL.md +16 -0
  17. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/providers/agent-skills/en/__PROVIDER__/skills/master-agent/SKILL.md +13 -0
  18. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/providers/agent-skills/es/__PROVIDER__/skills/master-agent/SKILL.md +14 -0
  19. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/providers/codex/en/.codex/agents/master-agent.toml +10 -0
  20. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/providers/codex/es/.codex/agents/master-agent.toml +10 -0
  21. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/en/AGENTS.md +7 -0
  22. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/en/__PROVIDER__/skills/content-editor/SKILL.md +20 -0
  23. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/es/AGENTS.md +7 -0
  24. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/es/__PROVIDER__/skills/content-editor/SKILL.md +20 -0
  25. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/agent-skills/shared/CLAUDE.md +1 -0
  26. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/codex/en/.codex/agents/content-editor.toml +19 -0
  27. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/providers/codex/es/.codex/agents/content-editor.toml +19 -0
  28. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/providers/codex/en/.codex/agents/demo-agent.toml +13 -0
  29. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/providers/codex/en/__PROVIDER__/skills/demo-command/SKILL.md +11 -0
  30. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/providers/codex/es/.codex/agents/demo-agent.toml +13 -0
  31. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/providers/codex/es/__PROVIDER__/skills/demo-command/SKILL.md +12 -0
  32. package/dist/cli/tutorial/sm-tutorial/references/_core.md +102 -49
  33. package/dist/cli/tutorial/sm-tutorial/references/_manifest.json +168 -20
  34. package/dist/cli/tutorial/sm-tutorial/references/_manifest.yml +85 -19
  35. package/dist/cli/tutorial/sm-tutorial/references/fixtures.md +6 -7
  36. package/dist/cli/tutorial/sm-tutorial/references/part-authoring.md +2 -2
  37. package/dist/cli/tutorial/sm-tutorial/references/part-basic-daily.md +241 -0
  38. package/dist/cli/tutorial/sm-tutorial/references/part-basic-fundamentals.md +351 -0
  39. package/dist/cli/tutorial/sm-tutorial/references/part-basic-kickoff.md +285 -0
  40. package/dist/cli/tutorial/sm-tutorial/references/part-cli.md +1 -1
  41. package/dist/cli/tutorial/sm-tutorial/references/part-daily-loop.md +62 -99
  42. package/dist/cli/tutorial/sm-tutorial/references/part-fundamentals.md +35 -34
  43. package/dist/cli/tutorial/sm-tutorial/references/part-mcp.md +3 -6
  44. package/dist/cli/tutorial/sm-tutorial/references/part-plugins.md +1 -1
  45. package/dist/cli/tutorial/sm-tutorial/references/part-project-kickoff.md +198 -26
  46. package/dist/cli/tutorial/sm-tutorial/references/part-settings.md +19 -15
  47. package/dist/cli/tutorial/sm-tutorial/scripts/fixtures.js +85 -22
  48. package/dist/cli/tutorial/sm-tutorial/scripts/lib/paths.js +74 -4
  49. package/dist/cli/tutorial/sm-tutorial/scripts/state.js +22 -6
  50. package/dist/cli.js +409 -168
  51. package/dist/conformance/index.js +42 -2
  52. package/dist/index.js +43 -30
  53. package/dist/kernel/index.d.ts +28 -5
  54. package/dist/kernel/index.js +43 -30
  55. package/dist/ui/chunk-22EQLC23.js +1845 -0
  56. package/dist/ui/chunk-3ANNEMV4.js +499 -0
  57. package/dist/ui/{chunk-5BJGO7GH.js → chunk-3U4QZKU2.js} +4 -4
  58. package/dist/ui/chunk-3ZAHOYQ7.js +1 -0
  59. package/dist/ui/{chunk-56CBK7LB.js → chunk-6FGV5O5J.js} +1 -1
  60. package/dist/ui/chunk-7WMT2LX4.js +1 -0
  61. package/dist/ui/{chunk-276RLZR4.js → chunk-BSIR3ADF.js} +14 -14
  62. package/dist/ui/{chunk-FC22ZJQZ.js → chunk-CG25RHMO.js} +1 -1
  63. package/dist/ui/chunk-EFSC6SOL.js +3 -0
  64. package/dist/ui/chunk-EJVWTBMV.js +4 -0
  65. package/dist/ui/chunk-EZI3BXQN.js +1 -0
  66. package/dist/ui/{chunk-JZ2YF7EL.js → chunk-GUPPOK7U.js} +8 -8
  67. package/dist/ui/{chunk-CJURGJTN.js → chunk-HLALESGR.js} +1 -1
  68. package/dist/ui/chunk-I3I4KHR5.js +2 -0
  69. package/dist/ui/{chunk-BOVJVOLH.js → chunk-I6ED2OW7.js} +1 -1
  70. package/dist/ui/chunk-JKPG5PO7.js +375 -0
  71. package/dist/ui/chunk-K3ZRQNN5.js +2 -0
  72. package/dist/ui/chunk-KHDWXSGR.js +1 -0
  73. package/dist/ui/{chunk-HEK4PH5A.js → chunk-KMHXNOFZ.js} +1 -1
  74. package/dist/ui/chunk-KWT7E2RJ.js +16 -0
  75. package/dist/ui/{chunk-WHZVGOS3.js → chunk-MQSU6EFZ.js} +1 -1
  76. package/dist/ui/{chunk-43S72FTV.js → chunk-OGEE252A.js} +1 -1
  77. package/dist/ui/{chunk-J4J42HJ4.js → chunk-PU5OP5RN.js} +1 -1
  78. package/dist/ui/{chunk-UTRZTB6V.js → chunk-QVG7J2MP.js} +1 -1
  79. package/dist/ui/chunk-TLMV4LOQ.js +3 -0
  80. package/dist/ui/chunk-TQBXK5JN.js +1 -0
  81. package/dist/ui/chunk-Z7SOKILO.js +2 -0
  82. package/dist/ui/{chunk-WCABR6TI.js → chunk-ZRJ5ZCFR.js} +1 -1
  83. package/dist/ui/index.html +2 -2
  84. package/dist/ui/main-R7BIU4HU.js +4 -0
  85. package/dist/ui/styles-VEGETYWD.css +1 -0
  86. package/package.json +17 -18
  87. package/dist/cli/tutorial/sm-tutorial/references/part-connect-harness.md +0 -173
  88. package/dist/ui/chunk-34ZZDYNQ.js +0 -1
  89. package/dist/ui/chunk-444BFYGR.js +0 -3
  90. package/dist/ui/chunk-44VNNUSQ.js +0 -2
  91. package/dist/ui/chunk-4SG4352Z.js +0 -7
  92. package/dist/ui/chunk-5ITZXW3A.js +0 -1
  93. package/dist/ui/chunk-7ANZW2OI.js +0 -499
  94. package/dist/ui/chunk-BJ6X6WBO.js +0 -4
  95. package/dist/ui/chunk-CZSLV6YD.js +0 -1
  96. package/dist/ui/chunk-DLYJHLJX.js +0 -2
  97. package/dist/ui/chunk-LGFABCIA.js +0 -16
  98. package/dist/ui/chunk-LPDD2DHE.js +0 -369
  99. package/dist/ui/chunk-P3SNMV4X.js +0 -2
  100. package/dist/ui/chunk-S4S5ZMXJ.js +0 -3
  101. package/dist/ui/chunk-VHEFRMK3.js +0 -1
  102. package/dist/ui/chunk-X6TRIDBI.js +0 -1845
  103. package/dist/ui/main-V77F2KZX.js +0 -4
  104. package/dist/ui/styles-I4ULXD3V.css +0 -1
  105. /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 4", off by one from the menu), a
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 Part 2
218
- additions), `master` (Part 4), `cli-external` (Part 5
219
- reference-paths). The script resolves the `__PROVIDER__` token,
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`): the prologue reveals its
246
- fixture progressively, so on entry lay ONLY the boot node, just
247
- before the tester's `sm init` in the `init` chapter:
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 4 `extend`): teaches plugins on its own
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 4 re-entry where the master fixture is already in place the
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 5 `cli`): reads the Part 0 demo
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 parts `connect-harness`, `daily-loop`): builds
299
- on the accumulating portfolio, but the tester may have jumped here.
300
- Run `state.js status`; if every predecessor up the `prereq` chain is
301
- `done`, the harness is already on disk, just `sm scan`. Otherwise
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 <harness-built|harness-connected> --provider <provider> --lang <lang>`
305
- (`harness-built` for `connect-harness`, `harness-connected` for
306
- `daily-loop`).
307
- 3. Provision the lens: the seeded portfolio has a root `AGENTS.md`
308
- (the `codex`/Codex marker) next to `.claude/`, but `codex` is
309
- experimental (ships disabled), so auto-detect ignores it and a plain `sm init`
310
- resolves the `claude` lens with no prompt. Run `sm init`, then
311
- `sm scan`. (If `.skill-map/` already exists, just `sm scan`.)
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,2 @@
1
+ - When a page needs writing or fixing, hand it to the [content-editor](.agents/skills/content-editor/SKILL.md).
2
+ - When the site is ready to go out, run [publish](.agents/skills/publish/SKILL.md).
@@ -0,0 +1,2 @@
1
+ - Cuando una página necesita escribirse o arreglarse, pasásela al [content-editor](.agents/skills/content-editor/SKILL.md).
2
+ - Cuando el sitio esté listo para salir, corré [publish](.agents/skills/publish/SKILL.md).
@@ -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__/commands/new-page.md"
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,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.