@skill-map/cli 0.60.4 → 0.61.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.
Files changed (87) hide show
  1. package/README.md +1 -1
  2. package/dist/cli/tutorial/sm-tutorial/SKILL.md +149 -266
  3. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/agents-hub/en/agents-hub.md +2 -0
  4. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/agents-hub/es/agents-hub.md +2 -0
  5. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/content-editor-style/en/content-editor-style.md +1 -0
  6. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/content-editor-style/es/content-editor-style.md +1 -0
  7. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-agent.md +1 -0
  8. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-command.md +1 -0
  9. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-guideline.md +1 -0
  10. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-guideline2.md +1 -0
  11. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-skill.md +1 -0
  12. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-agent.md +1 -0
  13. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-command.md +1 -0
  14. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-guideline.md +1 -0
  15. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-guideline2.md +1 -0
  16. package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-skill.md +1 -0
  17. package/dist/cli/tutorial/sm-tutorial/fixtures-data/manifest.json +87 -0
  18. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/cli-external/en/link-validation/hijoA/note-with-external-link.md +10 -0
  19. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/cli-external/en/link-validation/hijoB/spec.md +11 -0
  20. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/cli-external/es/link-validation/hijoA/note-with-external-link.md +10 -0
  21. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/cli-external/es/link-validation/hijoB/spec.md +11 -0
  22. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/en/__PROVIDER__/commands/publish.md +15 -0
  23. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/en/__PROVIDER__/skills/check-links/SKILL.md +16 -0
  24. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/es/__PROVIDER__/commands/publish.md +16 -0
  25. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/es/__PROVIDER__/skills/check-links/SKILL.md +17 -0
  26. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/en/__PROVIDER__/agents/master-agent.md +14 -0
  27. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/en/__PROVIDER__/skills/master-skill/SKILL.md +18 -0
  28. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/en/notes/ideas.md +11 -0
  29. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/es/__PROVIDER__/agents/master-agent.md +15 -0
  30. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/es/__PROVIDER__/skills/master-skill/SKILL.md +18 -0
  31. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/es/notes/ideas.md +11 -0
  32. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/AGENTS.md +6 -0
  33. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/__PROVIDER__/agents/content-editor.md +21 -0
  34. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/docs/DEPLOY.md +11 -0
  35. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/docs/STYLE.md +20 -0
  36. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/public/index.html +5 -0
  37. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/AGENTS.md +7 -0
  38. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/__PROVIDER__/agents/content-editor.md +21 -0
  39. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/docs/DEPLOY.md +12 -0
  40. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/docs/STYLE.md +21 -0
  41. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/public/index.html +5 -0
  42. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/shared/CLAUDE.md +1 -0
  43. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/shared/package.json +6 -0
  44. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/shared/server.js +11 -0
  45. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/__PROVIDER__/agents/demo-agent.md +18 -0
  46. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/__PROVIDER__/commands/demo-command.md +11 -0
  47. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/__PROVIDER__/skills/demo-skill/SKILL.md +16 -0
  48. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/notes/demo-guideline.md +16 -0
  49. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/notes/demo-guideline2.md +12 -0
  50. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/notes/private-credentials.md +11 -0
  51. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/notes/todo.md +9 -0
  52. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/__PROVIDER__/agents/demo-agent.md +18 -0
  53. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/__PROVIDER__/commands/demo-command.md +11 -0
  54. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/__PROVIDER__/skills/demo-skill/SKILL.md +16 -0
  55. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/notes/demo-guideline.md +16 -0
  56. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/notes/demo-guideline2.md +13 -0
  57. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/notes/private-credentials.md +11 -0
  58. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/notes/todo.md +9 -0
  59. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/universal/en/findings.md +10 -0
  60. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/universal/es/findings.md +10 -0
  61. package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/universal/shared/.skillmapignore +28 -0
  62. package/dist/cli/tutorial/sm-tutorial/references/_core.md +55 -40
  63. package/dist/cli/tutorial/sm-tutorial/references/_manifest.json +309 -0
  64. package/dist/cli/tutorial/sm-tutorial/references/_manifest.yml +1 -1
  65. package/dist/cli/tutorial/sm-tutorial/references/fixtures.md +94 -271
  66. package/dist/cli/tutorial/sm-tutorial/references/part-authoring.md +1 -2
  67. package/dist/cli/tutorial/sm-tutorial/references/part-cli.md +7 -30
  68. package/dist/cli/tutorial/sm-tutorial/references/part-connect-harness.md +12 -30
  69. package/dist/cli/tutorial/sm-tutorial/references/part-daily-loop.md +6 -4
  70. package/dist/cli/tutorial/sm-tutorial/references/part-fundamentals.md +14 -116
  71. package/dist/cli/tutorial/sm-tutorial/references/part-plugins.md +2 -3
  72. package/dist/cli/tutorial/sm-tutorial/references/part-project-kickoff.md +13 -65
  73. package/dist/cli/tutorial/sm-tutorial/scripts/fixtures.js +238 -0
  74. package/dist/cli/tutorial/sm-tutorial/scripts/lib/args.js +29 -0
  75. package/dist/cli/tutorial/sm-tutorial/scripts/lib/fixtures-manifest.js +32 -0
  76. package/dist/cli/tutorial/sm-tutorial/scripts/lib/io.js +37 -0
  77. package/dist/cli/tutorial/sm-tutorial/scripts/lib/manifest.js +24 -0
  78. package/dist/cli/tutorial/sm-tutorial/scripts/lib/paths.js +68 -0
  79. package/dist/cli/tutorial/sm-tutorial/scripts/state.js +262 -0
  80. package/dist/cli.js +7 -8
  81. package/dist/index.js +6 -4
  82. package/dist/kernel/index.js +6 -4
  83. package/dist/ui/chunk-FDBHGLTW.js +3 -0
  84. package/dist/ui/index.html +1 -1
  85. package/dist/ui/{main-VJJVD754.js → main-5GMGTLYQ.js} +1 -1
  86. package/package.json +5 -3
  87. package/dist/ui/chunk-DDDCORVR.js +0 -3
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: note-with-external-link
3
+ description: |
4
+ Demo note that links out to a sibling project (hijoB) sitting
5
+ next to this one. Used to teach scan.referencePaths.
6
+ ---
7
+
8
+ # Note with external link
9
+
10
+ See the [spec](../hijoB/spec.md) for the agreed format.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: spec
3
+ description: |
4
+ Target of the cross-folder link. Lives outside hijoA's scan
5
+ scope on purpose: that is precisely what scan.referencePaths
6
+ is designed to bridge.
7
+ ---
8
+
9
+ # External spec
10
+
11
+ Anything that hijoA points at lives here.
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: note-with-external-link
3
+ description: |
4
+ Nota de ejemplo que enlaza a un proyecto hermano (hijoB) que está
5
+ al lado de este. Se usa para enseñar scan.referencePaths.
6
+ ---
7
+
8
+ # Nota con enlace externo
9
+
10
+ Mira la [spec](../hijoB/spec.md) para el formato acordado.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: spec
3
+ description: |
4
+ Destino del enlace entre carpetas. Vive fuera del alcance de
5
+ escaneo de hijoA a propósito: eso es exactamente lo que
6
+ scan.referencePaths está diseñado para salvar.
7
+ ---
8
+
9
+ # Spec externa
10
+
11
+ Todo lo que hijoA apunta vive aquí.
@@ -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 command 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: check-links
3
+ description: |
4
+ Validates the portfolio's internal links before publishing. Walks
5
+ every generated page and reports any link whose target is missing.
6
+ ---
7
+
8
+ # check-links
9
+
10
+ The last gate before the site goes out.
11
+
12
+ ## Steps
13
+ 1. List every HTML file under `public/`.
14
+ 2. For each page, collect its internal links (every `href` to `/` or to a `.html` file).
15
+ 3. Check the target exists under `public/` (treat `/` as `public/index.html`).
16
+ 4. Report any link whose target is missing; if none, report "0 broken links".
@@ -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
+ El único comando 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,17 @@
1
+ ---
2
+ name: check-links
3
+ description: |
4
+ Valida los enlaces internos del portfolio antes de publicar.
5
+ Recorre cada página generada y reporta cualquier enlace cuyo
6
+ destino falte.
7
+ ---
8
+
9
+ # check-links
10
+
11
+ La última barrera antes de que el sitio salga.
12
+
13
+ ## Pasos
14
+ 1. Lista cada archivo HTML en `public/`.
15
+ 2. Para cada página, junta sus enlaces internos (cada `href` a `/` o a un archivo `.html`).
16
+ 3. Verifica que el destino exista en `public/` (trata `/` como `public/index.html`).
17
+ 4. Reporta cualquier enlace cuyo destino falte; si no hay ninguno, reporta "0 broken links".
@@ -0,0 +1,14 @@
1
+ ---
2
+ name: master-agent
3
+ description: |
4
+ Example agent used by the advanced tutorial. Has a couple of
5
+ tools so the `core/tools-counter` extractor emits a count.
6
+ tools: [Read, Bash, Edit]
7
+ model: sonnet
8
+ ---
9
+
10
+ # master-agent
11
+
12
+ Walks the master-skill outputs and reports findings. Used as the
13
+ target node when we exercise extractors, analyzers, and the
14
+ plugin-authoring flow.
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: master-skill
3
+ description: |
4
+ Example skill paired with the master-agent for the advanced
5
+ tutorial. Links to the agent so extractors and analyzers have
6
+ something to chew on.
7
+ ---
8
+
9
+ # master-skill
10
+
11
+ Hands heavy work over to the
12
+ [master-agent](../../agents/master-agent.md) and emits a Markdown
13
+ report.
14
+
15
+ ## Steps
16
+ 1. Read the `target`.
17
+ 2. Validate the frontmatter.
18
+ 3. Delegate to the agent.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: Ideas backlog
3
+ description: |
4
+ Free-form notes for the advanced tutorial. Demonstrates the
5
+ catch-all markdown kind alongside the agent and skill.
6
+ ---
7
+
8
+ # Ideas
9
+
10
+ - [ ] Compare extractor outputs side by side.
11
+ - [ ] Sketch a tiny plugin that surfaces a counter on the agent.
@@ -0,0 +1,15 @@
1
+ ---
2
+ name: master-agent
3
+ description: |
4
+ Agente de ejemplo que usa el tutorial avanzado. Tiene un par de
5
+ herramientas para que el extractor `core/tools-counter` emita un
6
+ conteo.
7
+ tools: [Read, Bash, Edit]
8
+ model: sonnet
9
+ ---
10
+
11
+ # master-agent
12
+
13
+ Recorre las salidas de master-skill y reporta hallazgos. Se usa como
14
+ el nodo objetivo cuando ejercitamos extractors, analyzers y el flujo
15
+ de autoría de plugins.
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: master-skill
3
+ description: |
4
+ Skill de ejemplo emparejada con master-agent para el tutorial
5
+ avanzado. Enlaza al agente para que los extractors y analyzers
6
+ tengan algo que masticar.
7
+ ---
8
+
9
+ # master-skill
10
+
11
+ Le pasa el trabajo pesado al
12
+ [master-agent](../../agents/master-agent.md) y emite un reporte en
13
+ Markdown.
14
+
15
+ ## Pasos
16
+ 1. Lee el `target`.
17
+ 2. Valida el frontmatter.
18
+ 3. Delega en el agente.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: Ideas backlog
3
+ description: |
4
+ Notas libres para el tutorial avanzado. Demuestra el tipo markdown
5
+ genérico junto al agente y la skill.
6
+ ---
7
+
8
+ # Ideas
9
+
10
+ - [ ] Comparar las salidas de los extractors lado a lado.
11
+ - [ ] Bocetar un plugin chico que muestre un contador en el agente.
@@ -0,0 +1,6 @@
1
+ # Portfolio handbook
2
+
3
+ A small static portfolio site, served by Express (`server.js`). The
4
+ `.claude/` harness maintains it: an agent writes the pages, a skill
5
+ checks the links, a command publishes. The conventions live in the
6
+ style guide; the deploy steps in the deploy runbook.
@@ -0,0 +1,21 @@
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
+ tools: [Read, Write]
7
+ model: sonnet
8
+ ---
9
+
10
+ # content-editor
11
+
12
+ Turns a short brief into a finished portfolio page.
13
+
14
+ ## How to write a page
15
+ 1. Read the style guide and the shared stylesheet in public/.
16
+ 2. Write one HTML file under public/, named after the page (a projects page becomes `public/projects.html`).
17
+ 3. Start from `<!doctype html>`, link the stylesheet with `<link rel="stylesheet" href="/style.css">`, and set a `<title>`.
18
+ 4. Use one `<h1>`, group sections under `<h2>`, and reuse the shared header, nav, and footer so every page matches.
19
+ 5. Add a link back to Home, and link the new page from the home nav.
20
+
21
+ Rules: plain static HTML, no framework, no client JS, one page per file.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: deploy-runbook
3
+ description: |
4
+ How the portfolio gets published once the pages are written.
5
+ ---
6
+
7
+ # Deploy runbook
8
+
9
+ 1. Generate or update the pages in public/.
10
+ 2. Run the link check and fix anything it reports.
11
+ 3. Start the server with `node server.js`, then open the site in your browser.
@@ -0,0 +1,20 @@
1
+ ---
2
+ name: style-guide
3
+ description: |
4
+ Writing and markup conventions every portfolio page follows.
5
+ ---
6
+
7
+ # Style guide
8
+
9
+ ## Voice
10
+ - Short, plain sentences. No marketing fluff.
11
+
12
+ ## Structure
13
+ - One H1 per page; sections under H2.
14
+ - Every page shares the same header, nav, and footer.
15
+ - Every page links back to Home.
16
+
17
+ ## Markup
18
+ - Plain static HTML: no framework, no client JS.
19
+ - Link the shared stylesheet `/style.css` in every page head.
20
+ - Use semantic tags: header, nav, main, footer.
@@ -0,0 +1,5 @@
1
+ <!doctype html>
2
+ <meta charset="utf-8">
3
+ <title>My portfolio</title>
4
+ <h1>My portfolio</h1>
5
+ <p>Pages land here once the content-editor generates them.</p>
@@ -0,0 +1,7 @@
1
+ # Manual del portfolio
2
+
3
+ Un sitio de portfolio estático y pequeño, servido por Express
4
+ (`server.js`). El harness `.claude/` lo mantiene: un agente escribe
5
+ las páginas, una skill revisa los enlaces, un comando publica. Las
6
+ convenciones viven en la guía de estilo; los pasos de despliegue en
7
+ el runbook de despliegue.
@@ -0,0 +1,21 @@
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
+ tools: [Read, Write]
7
+ model: sonnet
8
+ ---
9
+
10
+ # content-editor
11
+
12
+ Convierte un brief corto en una página de portfolio terminada.
13
+
14
+ ## Cómo escribir una página
15
+ 1. Lee la guía de estilo y la hoja de estilos compartida en public/.
16
+ 2. Escribe un archivo HTML en public/, nombrado según la página (una página de proyectos pasa a ser `public/projects.html`).
17
+ 3. Empieza desde `<!doctype html>`, enlaza la hoja de estilos con `<link rel="stylesheet" href="/style.css">` y define un `<title>`.
18
+ 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.
19
+ 5. Agrega un enlace de vuelta a Home, y enlaza la nueva página desde la nav de inicio.
20
+
21
+ Reglas: HTML estático plano, sin framework, sin JS de cliente, una página por archivo.
@@ -0,0 +1,12 @@
1
+ ---
2
+ name: deploy-runbook
3
+ description: |
4
+ Cómo se publica el portfolio una vez que las páginas están
5
+ escritas.
6
+ ---
7
+
8
+ # Runbook de despliegue
9
+
10
+ 1. Genera o actualiza las páginas en public/.
11
+ 2. Corre el chequeo de enlaces y arregla lo que reporte.
12
+ 3. Inicia el servidor con `node server.js`, luego abre el sitio en tu browser.
@@ -0,0 +1,21 @@
1
+ ---
2
+ name: style-guide
3
+ description: |
4
+ Convenciones de escritura y de markup que sigue cada página del
5
+ portfolio.
6
+ ---
7
+
8
+ # Guía de estilo
9
+
10
+ ## Voz
11
+ - Frases cortas y simples. Sin relleno de marketing.
12
+
13
+ ## Estructura
14
+ - Un H1 por página; las secciones bajo H2.
15
+ - Cada página comparte el mismo header, nav y footer.
16
+ - Cada página enlaza de vuelta a Home.
17
+
18
+ ## Markup
19
+ - HTML estático plano: sin framework, sin JS de cliente.
20
+ - Enlaza la hoja de estilos compartida `/style.css` en el head de cada página.
21
+ - Usa etiquetas semánticas: header, nav, main, footer.
@@ -0,0 +1,5 @@
1
+ <!doctype html>
2
+ <meta charset="utf-8">
3
+ <title>Mi portfolio</title>
4
+ <h1>Mi portfolio</h1>
5
+ <p>Las páginas aparecen aquí una vez que el content-editor las genera.</p>
@@ -0,0 +1,6 @@
1
+ {
2
+ "name": "my-portfolio",
3
+ "private": true,
4
+ "scripts": { "start": "node server.js" },
5
+ "dependencies": { "express": "4.21.2" }
6
+ }
@@ -0,0 +1,11 @@
1
+ // Minimal static server for the portfolio. No framework, one dep.
2
+ const express = require('express');
3
+ const path = require('node:path');
4
+
5
+ const app = express();
6
+ app.use(express.static(path.join(__dirname, 'public')));
7
+
8
+ const port = process.env.PORT || 3000;
9
+ app.listen(port, () => console.log(`Portfolio live at http://localhost:${port}`));
10
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a63b424c-683d-508e-b627-27d46322d194")}catch(e){}}();
11
+ //# debugId=a63b424c-683d-508e-b627-27d46322d194
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: demo-agent
3
+ description: |
4
+ Example agent that handles read and shell tasks. Solo node at
5
+ boot; gets connected to the rest of the demo fixture during the
6
+ Live UI step.
7
+ tools: [Read, Bash]
8
+ model: sonnet
9
+ ---
10
+
11
+ # demo-agent
12
+
13
+ Processes inputs and logs every action to stderr. Will be wired up
14
+ to the rest of the demo fixture later in the walkthrough.
15
+
16
+ Rules:
17
+ - Never run destructive commands without confirmation.
18
+ - Log every action to stderr.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: demo-command
3
+ description: |
4
+ Example slash command that wraps the demo-skill. Showcases the
5
+ `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,16 @@
1
+ ---
2
+ name: demo-skill
3
+ description: |
4
+ Example skill that walks a file and returns a Markdown report.
5
+ Showcases the `skill` kind in the demo map.
6
+ ---
7
+
8
+ # demo-skill
9
+
10
+ This skill walks a file and returns a report. Will be wired up
11
+ to the rest of the demo fixture in the next sub-step.
12
+
13
+ ## Steps
14
+ 1. Read the `target`.
15
+ 2. Validate the frontmatter against the schemas.
16
+ 3. Generate the report.
@@ -0,0 +1,16 @@
1
+ ---
2
+ name: demo-guideline
3
+ description: |
4
+ Static reference notes the rest of the demo points at. The hub
5
+ reaches it with a bare `@`-mention, which resolves to no agent,
6
+ so skill-map flags it as a broken reference (0.50) instead of
7
+ drawing an arrow.
8
+ ---
9
+
10
+ # Demo Guideline
11
+
12
+ Conventions the demo fixture follows:
13
+
14
+ - Names match the file basename.
15
+ - Frontmatter `description` is short and human-readable.
16
+ - Body stays minimal, only what's needed to teach the kind.
@@ -0,0 +1,12 @@
1
+ ---
2
+ name: demo-guideline2
3
+ description: |
4
+ Sibling of demo-guideline. The hub reaches it with an
5
+ `@`-mention that carries the `.md` extension, so the link
6
+ resolves to this file and lands certain (1.00).
7
+ ---
8
+
9
+ # Demo Guideline 2
10
+
11
+ Same conventions as demo-guideline; it exists so the hub can
12
+ reach it with a resolved reference instead of a bare mention.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: private-credentials
3
+ description: |
4
+ Personal API tokens, exists in the repo but should not show
5
+ up in skill-map's map. Demonstrates the .skillmapignore
6
+ flow.
7
+ ---
8
+
9
+ # Private
10
+
11
+ API_TOKEN: example-not-real
@@ -0,0 +1,9 @@
1
+ ---
2
+ name: Demo TODO list
3
+ description: |
4
+ Live list of things to review in the demo. Will become the
5
+ hub that points to the rest of the fixture in the next
6
+ sub-step.
7
+ ---
8
+
9
+ # Pending
@@ -0,0 +1,18 @@
1
+ ---
2
+ name: demo-agent
3
+ description: |
4
+ Agente de ejemplo que maneja tareas de lectura y de shell. Nodo
5
+ suelto al arranque; se conecta con el resto del set de prueba
6
+ durante el paso de la UI en vivo.
7
+ tools: [Read, Bash]
8
+ model: sonnet
9
+ ---
10
+
11
+ # demo-agent
12
+
13
+ Procesa entradas y registra cada acción en stderr. Se conectará
14
+ con el resto del set de prueba más adelante en el recorrido.
15
+
16
+ Reglas:
17
+ - Nunca ejecutes comandos destructivos sin confirmación.
18
+ - Registra cada acción en stderr.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: demo-command
3
+ description: |
4
+ Comando slash de ejemplo que envuelve a demo-skill. Muestra el
5
+ tipo `command`.
6
+ ---
7
+
8
+ # demo-command
9
+
10
+ Punto de entrada rápido para correr el flujo demo sobre un archivo
11
+ objetivo. Los conectores llegan en el próximo sub-paso.
@@ -0,0 +1,16 @@
1
+ ---
2
+ name: demo-skill
3
+ description: |
4
+ Skill de ejemplo que recorre un archivo y devuelve un reporte en
5
+ Markdown. Muestra el tipo `skill` en el mapa demo.
6
+ ---
7
+
8
+ # demo-skill
9
+
10
+ Esta skill recorre un archivo y devuelve un reporte. Se conectará
11
+ con el resto del set de prueba en el próximo sub-paso.
12
+
13
+ ## Pasos
14
+ 1. Lee el `target`.
15
+ 2. Valida el frontmatter contra los schemas.
16
+ 3. Genera el reporte.
@@ -0,0 +1,16 @@
1
+ ---
2
+ name: demo-guideline
3
+ description: |
4
+ Notas de referencia estáticas a las que apunta el resto de la
5
+ demo. El hub la alcanza con una mención `@` simple, que no
6
+ resuelve a ningún agente, así que skill-map la marca como
7
+ referencia rota (0.50) en lugar de dibujar una flecha.
8
+ ---
9
+
10
+ # Demo Guideline
11
+
12
+ Convenciones que sigue el set de prueba demo:
13
+
14
+ - Los nombres coinciden con el basename del archivo.
15
+ - El `description` del frontmatter es corto y legible.
16
+ - El cuerpo queda mínimo, solo lo necesario para enseñar el tipo.
@@ -0,0 +1,13 @@
1
+ ---
2
+ name: demo-guideline2
3
+ description: |
4
+ Hermano de demo-guideline. El hub lo alcanza con una mención `@`
5
+ que lleva la extensión `.md`, así que el enlace resuelve a este
6
+ archivo y queda certero (1.00).
7
+ ---
8
+
9
+ # Demo Guideline 2
10
+
11
+ Las mismas convenciones que demo-guideline; existe para que el hub
12
+ pueda alcanzarlo con una referencia resuelta en lugar de una
13
+ mención simple.
@@ -0,0 +1,11 @@
1
+ ---
2
+ name: private-credentials
3
+ description: |
4
+ Tokens de API personales, existe en el repo pero no debería
5
+ aparecer en el mapa de skill-map. Demuestra el flujo de
6
+ .skillmapignore.
7
+ ---
8
+
9
+ # Privado
10
+
11
+ API_TOKEN: example-not-real
@@ -0,0 +1,9 @@
1
+ ---
2
+ name: Demo TODO list
3
+ description: |
4
+ Lista en vivo de cosas para revisar en la demo. Se convertirá en
5
+ el hub que apunta al resto del set de prueba en el próximo
6
+ sub-paso.
7
+ ---
8
+
9
+ # Pendientes
@@ -0,0 +1,10 @@
1
+ # Findings: sm-tutorial
2
+
3
+ If you spot anything weird during the tutorial, log it here.
4
+
5
+ Per finding:
6
+ - **Chapter**: <id>
7
+ - **Command**: `sm ...`
8
+ - **Expected**: ...
9
+ - **Got**: ...
10
+ - **Notes**: ...
@@ -0,0 +1,10 @@
1
+ # Hallazgos: sm-tutorial
2
+
3
+ Si ves algo raro durante el tutorial, anótalo aquí.
4
+
5
+ Por hallazgo:
6
+ - **Capítulo**: <id>
7
+ - **Comando**: `sm ...`
8
+ - **Esperado**: ...
9
+ - **Obtenido**: ...
10
+ - **Notas**: ...
@@ -0,0 +1,28 @@
1
+ # Bundled defaults that matter inside the tutorial scope.
2
+ .git/
3
+ .skill-map/
4
+ .tmp/
5
+ .DS_Store
6
+
7
+ # sm-tutorial internal files. Without these, the first sm init scan
8
+ # reports the tutorial's own .md files as project nodes.
9
+ sm-tutorial.md
10
+ findings.md
11
+ tutorial-state.json
12
+
13
+ # sm-tutorial skill installation (loaded as a project-local skill).
14
+ .claude/skills/sm-tutorial/
15
+ .agents/skills/sm-tutorial/
16
+
17
+ # Tutorial outputs that may land at the root.
18
+ export.*
19
+ dump.sql
20
+
21
+ # The reference-paths chapter spawns a self-contained sub-project
22
+ # under link-validation/hijoA with its own .skill-map/.
23
+ link-validation/
24
+
25
+ # Portfolio campaign: the Express install and the generated HTML
26
+ # (the site output, not part of the harness graph).
27
+ node_modules/
28
+ public/