@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.
- package/README.md +1 -1
- package/dist/cli/tutorial/sm-tutorial/SKILL.md +149 -266
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/agents-hub/en/agents-hub.md +2 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/agents-hub/es/agents-hub.md +2 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/content-editor-style/en/content-editor-style.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/content-editor-style/es/content-editor-style.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-agent.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-command.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-guideline.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-guideline2.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/en/todo-bullet-skill.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-agent.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-command.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-guideline.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-guideline2.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/edits/todo-connectors/es/todo-bullet-skill.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/manifest.json +87 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/cli-external/en/link-validation/hijoA/note-with-external-link.md +10 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/cli-external/en/link-validation/hijoB/spec.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/cli-external/es/link-validation/hijoA/note-with-external-link.md +10 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/cli-external/es/link-validation/hijoB/spec.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/en/__PROVIDER__/commands/publish.md +15 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/en/__PROVIDER__/skills/check-links/SKILL.md +16 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/es/__PROVIDER__/commands/publish.md +16 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/es/__PROVIDER__/skills/check-links/SKILL.md +17 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/en/__PROVIDER__/agents/master-agent.md +14 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/en/__PROVIDER__/skills/master-skill/SKILL.md +18 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/en/notes/ideas.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/es/__PROVIDER__/agents/master-agent.md +15 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/es/__PROVIDER__/skills/master-skill/SKILL.md +18 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/master/es/notes/ideas.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/AGENTS.md +6 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/__PROVIDER__/agents/content-editor.md +21 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/docs/DEPLOY.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/docs/STYLE.md +20 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/en/public/index.html +5 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/AGENTS.md +7 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/__PROVIDER__/agents/content-editor.md +21 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/docs/DEPLOY.md +12 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/docs/STYLE.md +21 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/es/public/index.html +5 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/shared/CLAUDE.md +1 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/shared/package.json +6 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/portfolio/shared/server.js +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/__PROVIDER__/agents/demo-agent.md +18 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/__PROVIDER__/commands/demo-command.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/__PROVIDER__/skills/demo-skill/SKILL.md +16 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/notes/demo-guideline.md +16 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/notes/demo-guideline2.md +12 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/notes/private-credentials.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/en/notes/todo.md +9 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/__PROVIDER__/agents/demo-agent.md +18 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/__PROVIDER__/commands/demo-command.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/__PROVIDER__/skills/demo-skill/SKILL.md +16 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/notes/demo-guideline.md +16 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/notes/demo-guideline2.md +13 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/notes/private-credentials.md +11 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/prologue/es/notes/todo.md +9 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/universal/en/findings.md +10 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/universal/es/findings.md +10 -0
- package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/universal/shared/.skillmapignore +28 -0
- package/dist/cli/tutorial/sm-tutorial/references/_core.md +55 -40
- package/dist/cli/tutorial/sm-tutorial/references/_manifest.json +309 -0
- package/dist/cli/tutorial/sm-tutorial/references/_manifest.yml +1 -1
- package/dist/cli/tutorial/sm-tutorial/references/fixtures.md +94 -271
- package/dist/cli/tutorial/sm-tutorial/references/part-authoring.md +1 -2
- package/dist/cli/tutorial/sm-tutorial/references/part-cli.md +7 -30
- package/dist/cli/tutorial/sm-tutorial/references/part-connect-harness.md +12 -30
- package/dist/cli/tutorial/sm-tutorial/references/part-daily-loop.md +6 -4
- package/dist/cli/tutorial/sm-tutorial/references/part-fundamentals.md +14 -116
- package/dist/cli/tutorial/sm-tutorial/references/part-plugins.md +2 -3
- package/dist/cli/tutorial/sm-tutorial/references/part-project-kickoff.md +13 -65
- package/dist/cli/tutorial/sm-tutorial/scripts/fixtures.js +238 -0
- package/dist/cli/tutorial/sm-tutorial/scripts/lib/args.js +29 -0
- package/dist/cli/tutorial/sm-tutorial/scripts/lib/fixtures-manifest.js +32 -0
- package/dist/cli/tutorial/sm-tutorial/scripts/lib/io.js +37 -0
- package/dist/cli/tutorial/sm-tutorial/scripts/lib/manifest.js +24 -0
- package/dist/cli/tutorial/sm-tutorial/scripts/lib/paths.js +68 -0
- package/dist/cli/tutorial/sm-tutorial/scripts/state.js +262 -0
- package/dist/cli.js +7 -8
- package/dist/index.js +6 -4
- package/dist/kernel/index.js +6 -4
- package/dist/ui/chunk-FDBHGLTW.js +3 -0
- package/dist/ui/index.html +1 -1
- package/dist/ui/{main-VJJVD754.js → main-5GMGTLYQ.js} +1 -1
- package/package.json +5 -3
- 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,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í.
|
package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/en/__PROVIDER__/commands/publish.md
ADDED
|
@@ -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".
|
package/dist/cli/tutorial/sm-tutorial/fixtures-data/sets/harness/es/__PROVIDER__/commands/publish.md
ADDED
|
@@ -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,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 @@
|
|
|
1
|
+
@AGENTS.md
|
|
@@ -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,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,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,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/
|