claude-code-arcane 1.4.0 → 2.1.0

package/skills/master-profile/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: master-profile
-description: "Build and maintain the master professional profile — the single source of truth (experience, skills with levels, projects, education, references, bios) that every CV, LinkedIn profile and portfolio derives from. Triggers: perfil maestro, master resume, cronologia laboral, single source of truth CV, mi experiencia profesional."
+description: "Build and maintain the master professional profile - the single source of truth (experience, skills with levels, projects, education, references, bios) that every CV, LinkedIn profile and portfolio derives from. Triggers: perfil maestro, master resume, cronologia laboral, single source of truth CV, mi experiencia profesional."
 argument-hint: "[build | update | derive <role>]"
 category: "career"
 user-invocable: true
 allowed-tools: Read, Glob, Grep, Write, Edit
 ---
 
-# Master Profile — Single Source of Truth
+# Master Profile - Single Source of Truth
 
 Construís y mantenés el **perfil maestro**: el documento del que derivan todos los CVs, el LinkedIn y el portfolio. La regla de oro: **si algo cambia, se cambia acá primero** y de acá se sincroniza al resto.
 
@@ -21,32 +21,32 @@ Mantener N CVs sincronizados a mano es la causa #1 de errores (fechas que no coi
 
 Generá el archivo con estas secciones (todas las que apliquen):
 
-1. **Personal info** — nombre, display name, headline actual, ubicación, email público vs personal, teléfono, LinkedIn, GitHub, portfolio. (El email *público* puede diferir del personal.)
-2. **Bios** — tres largos: corto (hero/one-liner), medio (2–3 oraciones para "About"), largo (about page completo).
-3. **Work experience** (más reciente primero) — por cada rol: empresa, período, ubicación/modalidad, producto, stack, manager/referencia, y **bullets de logros con número→contexto→resultado**.
-4. **Education** — institución, período, foco.
-5. **Certifications** — nombre, año, estado (completo/in progress).
-6. **Skills consolidados con nivel** — agrupados (lenguajes, frameworks, infra, tooling) con nivel (Expert/Advanced/Proficient/…) y opcionalmente % para el portfolio.
-7. **Projects** — tech, rol, highlights, link en vivo.
-8. **Achievements / highlights** — premios, showcases, hitos.
-9. **Languages** — idioma + nivel.
-10. **References** — nombre, rol, relación, contacto.
+1. **Personal info** - nombre, display name, headline actual, ubicación, email público vs personal, teléfono, LinkedIn, GitHub, portfolio. (El email *público* puede diferir del personal.)
+2. **Bios** - tres largos: corto (hero/one-liner), medio (2-3 oraciones para "About"), largo (about page completo).
+3. **Work experience** (más reciente primero) - por cada rol: empresa, período, ubicación/modalidad, producto, stack, manager/referencia, y **bullets de logros con número→contexto→resultado**.
+4. **Education** - institución, período, foco.
+5. **Certifications** - nombre, año, estado (completo/in progress).
+6. **Skills consolidados con nivel** - agrupados (lenguajes, frameworks, infra, tooling) con nivel (Expert/Advanced/Proficient/…) y opcionalmente % para el portfolio.
+7. **Projects** - tech, rol, highlights, link en vivo.
+8. **Achievements / highlights** - premios, showcases, hitos.
+9. **Languages** - idioma + nivel.
+10. **References** - nombre, rol, relación, contacto.
 
 ## Modos
 
-### `build` — Crear el maestro desde cero
+### `build` - Crear el maestro desde cero
 1. Si no existe el workspace, sugerir `/job-hunt setup` primero.
-2. Recolectar info por sección — preferí **entrevistar al usuario por bloques** (no un cuestionario gigante). Empezá por experiencia y skills.
+2. Recolectar info por sección - preferí **entrevistar al usuario por bloques** (no un cuestionario gigante). Empezá por experiencia y skills.
 3. Para cada logro, empujar a la forma **cuantificable**: "¿qué número podés ponerle? ¿comparado con qué? ¿qué resultado tuvo?". Un bullet sin métrica es una oportunidad perdida.
 4. Escribir `01-Perfiles/Perfil Maestro.md`.
 5. Sugerir derivar el primer perfil por rol: `/master-profile derive <role>`.
 
-### `update` — Mantener al día
+### `update` - Mantener al día
 1. Leer el maestro actual.
 2. Aplicar el cambio (nuevo rol, nuevo logro, ascenso, proyecto).
 3. **Avisar qué derivados quedan desactualizados** (CVs por rol, LinkedIn, portfolio) y ofrecer re-derivarlos.
 
-### `derive <role>` — Vista por rol
+### `derive <role>` - Vista por rol
 1. Leer el maestro.
 2. Crear/actualizar `01-Perfiles/<Role>.md` con el template `Perfil` (ver `Templates/Perfil.md`): filtrar y reordenar la experiencia/skills/proyectos hacia ese rol, definir keywords objetivo, score mínimo y mercado.
 3. Este perfil por rol es el `perfil_base` que después usa `/cv-tailor`.
@@ -61,7 +61,7 @@ Generá el archivo con estas secciones (todas las que apliquen):
 ## Reglas
 
 - Una sola fuente de verdad: no dejar que un CV por rol "evolucione" por fuera del maestro.
-- No inventar logros ni métricas — si el usuario no tiene el número, marcarlo como pendiente, no fabricarlo.
+- No inventar logros ni métricas - si el usuario no tiene el número, marcarlo como pendiente, no fabricarlo.
 - Separar email público de personal; no exponer datos sensibles en archivos que vayan a un remoto.
 
 ## Handoff

package/skills/network-map/SKILL.md

@@ -7,7 +7,7 @@ user-invocable: true
 allowed-tools: Read, Glob, Grep, Bash, Write, Edit
 ---
 
-# Network Map — Inteligencia de contactos para warm intros
+# Network Map - Inteligencia de contactos para warm intros
 
 Convertís el **export de conexiones de LinkedIn** en inteligencia accionable: dado un target company, quién de tu red 1er-grado trabaja (o trabajó) ahí, quién puede darte un warm intro, y un mensaje custom por contacto. Reemplaza a LinkedIn Premium para esto: solo necesitás tu propio export + Claude.
 
@@ -20,9 +20,9 @@ En LinkedIn → **Settings → Data Privacy → Get a copy of your data → Down
 ## Qué produce
 
 Dado un target company:
-1. **1er-grado en la empresa** — contactos tuyos que trabajan ahí ahora (match por `Company`).
-2. **Paths de warm intro** — contactos 1er-grado que probablemente conozcan gente del target (ej. ex-empleados de la empresa, gente del mismo rubro/rol) y podrían presentarte. *Nota honesta:* el export solo tiene tus 1er-grado; el verdadero 2do-grado (las conexiones de ellos) no está en el archivo. Lo que hacemos es **inferir** buenos candidatos a intro desde tus 1er-grado (empleo actual/pasado en el target, overlap de empresa/rol), no leer la red de cada uno.
-3. **Mensaje por contacto** — template custom según historia compartida (misma empresa pasada, mismo rubro, conexión vieja vs reciente).
+1. **1er-grado en la empresa** - contactos tuyos que trabajan ahí ahora (match por `Company`).
+2. **Paths de warm intro** - contactos 1er-grado que probablemente conozcan gente del target (ej. ex-empleados de la empresa, gente del mismo rubro/rol) y podrían presentarte. *Nota honesta:* el export solo tiene tus 1er-grado; el verdadero 2do-grado (las conexiones de ellos) no está en el archivo. Lo que hacemos es **inferir** buenos candidatos a intro desde tus 1er-grado (empleo actual/pasado en el target, overlap de empresa/rol), no leer la red de cada uno.
+3. **Mensaje por contacto** - template custom según historia compartida (misma empresa pasada, mismo rubro, conexión vieja vs reciente).
 
 ## El motor
 
@@ -40,10 +40,10 @@ Devuelve nombre, posición, empresa, URL del perfil y fecha de conexión. Vos (C
 
 ## Modos
 
-### `import <path>` — Registrar el export
+### `import <path>` - Registrar el export
 Copiar/referenciar `Connections.csv` en `05-Contactos/`, verificar que parsea (corré el script con `--top-companies`), y reportar tamaño de la red + top empresas.
 
-### `[company]` — Mapear una empresa
+### `[company]` - Mapear una empresa
 1. Correr el script filtrando por la empresa.
 2. Clasificar: 1er-grado actuales en la empresa vs candidatos a warm-intro (ex-empleados / mismo rubro).
 3. Priorizar por relevancia (seniority/rol vs tu objetivo) y calidez (conexión reciente, historia compartida).
@@ -53,7 +53,7 @@ Copiar/referenciar `Connections.csv` en `05-Contactos/`, verificar que parsea (c
 ## Reglas
 
 - Data de terceros: tratamiento local, nunca a un remoto sin confirmación; respetá privacidad.
-- No inventar relaciones ni 2do-grado que el export no soporta — sé explícito sobre qué es dato y qué es inferencia.
+- No inventar relaciones ni 2do-grado que el export no soporta - sé explícito sobre qué es dato y qué es inferencia.
 - Calidad sobre cantidad: 5 contactos bien elegidos > 50 mensajes genéricos.
 
 ## Handoff

package/skills/obsidian-bases/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: obsidian-bases
+description: "Crea y edita archivos .base de Obsidian: vistas table/cards/list/map, filtros, formulas y summaries sobre las propiedades de las notas. Incluye migracion desde queries de Dataview. Triggers: obsidian bases, archivo .base, base de datos en obsidian, vista de notas, dashboard obsidian, migrar dataview."
+argument-hint: "[create <descripcion> | explain <archivo.base> | migrate <query dataview>]"
+category: "pkm"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit
+---
+
+# Obsidian Bases - Vistas nativas
+
+Bases es el core plugin de Obsidian (1.9+) que convierte las propiedades de las notas en tablas y cards vivas. No se instala nada. Adaptado de `kepano/obsidian-skills` al formato de este repo.
+
+Modo: `$ARGUMENTS`
+
+La referencia completa de sintaxis está en `references/bases-syntax.md`. Leela antes de escribir un `.base`: la mitad de los errores son de quoting de YAML, no de lógica.
+
+## Fase 1 - Verificar que Bases esté disponible
+
+Leer `.obsidian/core-plugins.json` del vault. Si `bases` no está habilitado, decirlo y ofrecer las dos salidas: habilitarlo (es core, no requiere instalar) o resolver la vista con una tabla markdown estática. **Nunca escribir un `.base` en un vault que no lo tiene habilitado:** queda como un archivo que Obsidian muestra en crudo.
+
+## Fase 2 - Modos
+
+### `create` - Vista nueva
+1. Entender qué pregunta responde la vista. Una vista sin pregunta concreta termina siendo una tabla de todo el vault que nadie mira.
+2. **Verificar que las propiedades existan**: `Grep` en el frontmatter del vault por los campos que vas a filtrar. Filtrar por una propiedad que ninguna nota declara produce una vista vacía y parece un bug de Bases.
+3. Escribir el `.base` en `Bases/`, con approval antes de crear el archivo.
+4. Avisar que hay que abrirlo en Obsidian para confirmar que renderiza: la sintaxis se valida ahí, no acá.
+
+### `explain` - Leer un `.base` existente
+Traducir el archivo a lenguaje llano: qué notas entran, qué columnas muestra, qué calcula cada fórmula. Read-only.
+
+### `migrate` - Desde Dataview
+Traducir la query, y **decir explícitamente qué no se puede traducir**. Bases no cubre campos inline (`campo:: valor` en medio de la nota) ni texto computado ni `dataviewjs`. Si la query depende de eso, la respuesta honesta es que se quede en Dataview: una migración a medias deja al usuario con una vista que miente.
+
+## Estructura de un `.base`
+
+```yaml
+filters:
+  and:
+    - file.inFolder("03_Resources")
+    - 'type == "atomic"'
+
+formulas:
+  edad_dias: '(now() - file.mtime).days'
+
+properties:
+  formula.edad_dias:
+    displayName: "Dias sin tocar"
+
+views:
+  - type: table
+    name: "Notas atomicas"
+    filters:
+      not:
+        - file.hasTag("archivada")
+    order:
+      - file.name
+      - created
+      - formula.edad_dias
+    summaries:
+      formula.edad_dias: Average
+```
+
+Los cinco bloques top-level son `filters`, `formulas`, `properties`, `summaries` y `views`. Los filtros globales aplican a todas las vistas; cada vista puede agregar los suyos.
+
+## Los tres errores que se repiten
+
+1. **Quoting de YAML.** Cualquier expresión con `:`, `{`, `}`, `[`, `]` va entre comillas. Si la expresión ya tiene comillas dobles adentro, el string va en comillas simples: `'if(done, "Si", "No")'`.
+2. **Duraciones.** Restar dos fechas da una `Duration`, no un número: hay que acceder al campo antes de operar (`.days`, `.hours`). `round(now() - file.mtime)` falla; `(now() - file.mtime).days` funciona.
+3. **Nulls.** Una propiedad ausente rompe la fórmula. Envolver en `if(propiedad, ...)` cuando el campo puede faltar, que en un vault real es casi siempre.
+
+Una fórmula referenciada en `order` que no está declarada en `formulas` falla en silencio: la columna simplemente no aparece.
+
+## Reglas
+
+- `file.backlinks` es caro: no lo pongas en una vista que se abre seguido.
+- No crear una vista que dependa de una propiedad que el vault todavía no usa: primero se agrega al contrato de frontmatter del `CLAUDE.md`.
+- Un `.base` por pregunta. Un archivo con ocho vistas es un dashboard que nadie lee.
+- Pedí approval antes de escribir o sobrescribir un `.base`.
+- Sin guiones largos.
+
+## Handoff
+
+Base READY cuando el archivo existe y el usuario confirmó que renderiza en Obsidian. Si la vista necesitaba campos que las notas no tienen, el siguiente paso es actualizar el contrato de frontmatter con `/second-brain` y completar las notas con `/vault-tidy frontmatter`.

package/skills/obsidian-bases/references/bases-syntax.md

@@ -0,0 +1,123 @@
+# Bases Syntax Reference
+
+Referencia de la sintaxis de los archivos `.base` de Obsidian (core plugin, 1.9+). Fuente: `https://obsidian.md/help/bases/syntax`.
+
+## Bloques top-level
+
+| Bloque | Qué hace |
+|---|---|
+| `filters` | Condiciones globales, aplican a todas las vistas. Opcional. |
+| `formulas` | Propiedades calculadas, disponibles en todas las vistas. |
+| `properties` | Configuración de display de una propiedad (`displayName`). |
+| `summaries` | Fórmulas de agregación propias. |
+| `views` | Lista de vistas: cómo se renderizan los datos. |
+
+Sin `filters`, la base incluye **todos** los archivos del vault.
+
+## Filtros
+
+Un objeto de filtro contiene `and`, `or` o `not`, y cada uno una lista de objetos de filtro o de statements (strings). Se anidan.
+
+```yaml
+filters:
+  or:
+    - file.hasTag("tag")
+    - and:
+        - file.hasTag("book")
+        - file.hasLink("Textbook")
+    - not:
+        - file.hasTag("book")
+        - file.inFolder("Required Reading")
+```
+
+Operadores:
+
+- Aritméticos: `+`, `-`, `*`, `/`, `%`, `()`
+- Comparación: `==`, `!=`, `>`, `<`, `>=`, `<=`
+- Booleanos: `!`, `&&`, `||`
+- Fechas: sumar o restar duraciones con `+` y `-`. Unidades: `y/year/years`, `M/month/months`, `w/week/weeks`, `d/day/days`, `h/hour/hours`, `m/minute/minutes`, `s/second/seconds`
+
+## Propiedades
+
+Tres orígenes:
+
+| Forma | Origen |
+|---|---|
+| `note.propiedad` o `propiedad` | frontmatter de la nota |
+| `file.*` | metadata del archivo |
+| `formula.nombre` | fórmula declarada en `formulas` |
+
+Propiedades de archivo: `file.name`, `file.path`, `file.folder`, `file.ext`, `file.size`, `file.ctime`, `file.mtime`, `file.tags`, `file.links`, `file.embeds`, `file.backlinks`.
+
+`file.backlinks` es costoso de calcular: evitarlo en vistas de uso frecuente.
+
+Tipos de dato: strings (entre comillas), números, booleanos (`true`/`false`), fechas, duraciones, objetos, listas, y files/links.
+
+## Fórmulas
+
+```yaml
+formulas:
+  formatted_price: 'if(price, price.toFixed(2) + " dollars")'
+  ppu: "(price / age).toFixed(2)"
+```
+
+Funciones habituales: `if()`, `date()`, `now()`, `duration()`, además de los métodos de cada tipo (`toFixed`, `round`, `mean`).
+
+Tres trampas:
+
+1. **Duraciones:** una resta de fechas devuelve `Duration`. Hay que acceder al campo numérico antes de operar: `(now() - file.mtime).days`, no `round(now() - file.mtime)`.
+2. **Nulls:** una propiedad ausente rompe la fórmula. Envolver en `if(propiedad, ...)`.
+3. **Referencias:** una `formula.x` usada en `order` pero no declarada en `formulas` falla en silencio, la columna no aparece.
+
+## Vistas
+
+```yaml
+views:
+  - type: table
+    name: "My table"
+    limit: 10
+    groupBy:
+      property: note.age
+      direction: DESC
+    filters:
+      and:
+        - 'status != "done"'
+        - or:
+            - "formula.ppu > 5"
+            - "price > 2.1"
+    order:
+      - file.name
+      - note.age
+      - formula.ppu
+    summaries:
+      formula.ppu: Average
+```
+
+Claves de una vista: `type`, `name`, `limit`, `groupBy`, `filters`, `order`, `summaries`.
+
+Tipos: `table` (columnas), `cards` (galería), `list` (lista simple), `map` (geográfico).
+
+## Summaries por default
+
+- Numéricos: Average, Min, Max, Sum, Range, Median, Stddev
+- Fechas: Earliest, Latest
+- Booleanos: Checked, Unchecked
+- Cualquier tipo: Empty, Filled, Unique
+
+Propios:
+
+```yaml
+summaries:
+  customAverage: 'values.mean().round(3)'
+```
+
+## Quoting de YAML
+
+Cualquier expresión que contenga `:`, `{`, `}`, `[`, `]` va entre comillas. Si la expresión tiene comillas dobles adentro, el string va entre comillas simples:
+
+```yaml
+formulas:
+  label: 'if(done, "Yes", "No")'
+```
+
+Es la causa número uno de un `.base` que no carga.

package/skills/obsidian-canvas/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: obsidian-canvas
+description: "Crea y edita archivos .canvas (JSON Canvas): nodos de nota, texto, archivo y link, grupos y edges con direccion y color. Triggers: obsidian canvas, json canvas, mapa visual, diagrama de notas, archivo .canvas, pizarra obsidian."
+argument-hint: "[create <descripcion> | explain <archivo.canvas> | edit <archivo.canvas>]"
+category: "pkm"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit
+---
+
+# Obsidian Canvas - JSON Canvas
+
+Un `.canvas` es JSON plano con dos arrays: `nodes` y `edges`. El formato es JSON Canvas, un spec abierto, así que el archivo se puede generar y leer sin Obsidian. Adaptado de `kepano/obsidian-skills` al formato de este repo.
+
+Modo: `$ARGUMENTS`
+
+## Modos
+
+- **`create`**: generar un canvas nuevo desde una descripción o desde un conjunto de notas del vault.
+- **`explain`**: leer un canvas y describir su estructura en texto. Read-only.
+- **`edit`**: agregar o reacomodar nodos de un canvas existente. Pedí approval antes de escribir, y avisá que un canvas abierto en Obsidian sobrescribe el archivo al guardar: hay que cerrarlo antes.
+
+## Estructura
+
+```json
+{
+  "nodes": [
+    {
+      "id": "n1",
+      "type": "file",
+      "file": "03_Resources/Indices parciales.md",
+      "x": 0, "y": 0, "width": 400, "height": 300
+    },
+    {
+      "id": "n2",
+      "type": "text",
+      "text": "Hipotesis: el costo esta en las lecturas",
+      "x": 480, "y": 0, "width": 300, "height": 120,
+      "color": "4"
+    },
+    {
+      "id": "g1",
+      "type": "group",
+      "label": "Investigacion",
+      "x": -40, "y": -60, "width": 900, "height": 440
+    }
+  ],
+  "edges": [
+    {
+      "id": "e1",
+      "fromNode": "n1", "fromSide": "right",
+      "toNode": "n2", "toSide": "left",
+      "label": "sugiere"
+    }
+  ]
+}
+```
+
+**Nodos.** Campos obligatorios: `id`, `type`, `x`, `y`, `width`, `height`. Tipos:
+
+| `type` | Campo propio |
+|---|---|
+| `text` | `text` (markdown) |
+| `file` | `file` (ruta en el vault), `subpath` opcional para un heading o bloque |
+| `link` | `url` |
+| `group` | `label`, `background`, `backgroundStyle` opcionales |
+
+**Edges.** Obligatorio `id`, `fromNode`, `toNode`. Opcionales: `fromSide` y `toSide` (`top`, `right`, `bottom`, `left`), `fromEnd`/`toEnd` (`none`, `arrow`), `label`, `color`.
+
+**Color.** Un preset `"1"` a `"6"` (rojo, naranja, amarillo, verde, cyan, violeta) o un hex `"#ff0000"`.
+
+**Coordenadas.** El eje Y crece hacia abajo. Un grupo no contiene nodos por referencia: los contiene **geométricamente**, por solaparse con su rectángulo. Si movés un nodo fuera del rectángulo, sale del grupo.
+
+## Reglas para generar uno usable
+
+- **Los `id` tienen que ser únicos.** Si se repiten, Obsidian se queda con uno solo y el resto desaparece sin error.
+- **Layout en grilla, no apilado en el origen.** Separar los nodos al menos 60px: un canvas con todo en `x: 0, y: 0` se abre como una pila ilegible y reacomodarlo a mano cuesta más que generarlo de nuevo.
+- **Verificar que cada `file` exista** antes de escribir el canvas: un nodo que apunta a una nota inexistente renderiza vacío.
+- Un canvas es para pensar visualmente, no para almacenar conocimiento. Lo que se aprende en un canvas se escribe después como nota atómica.
+
+Canvas READY cuando el JSON es válido, los ids son únicos, las rutas existen y el usuario confirmó que abre bien en Obsidian.
+
+## Reglas
+
+- No inventar campos que el spec no define: Obsidian los ignora y ensucia el archivo.
+- No reescribir un canvas entero para agregar un nodo: `Edit` sobre el array.
+- Pedí approval antes de escribir o sobrescribir un `.canvas`, y verificá que no esté abierto en Obsidian.
+- Sin guiones largos en labels ni en nodos de texto.
+
+## Handoff
+
+Si lo que hacía falta era una vista tabular y no un mapa visual, el skill correcto es `/obsidian-bases`. Cuando el canvas dejó una conclusión, el siguiente paso es `/zettel` para escribirla como nota atómica: el canvas es el andamio, la nota es lo que queda.

package/skills/obsidian-markdown/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: obsidian-markdown
+description: "Sintaxis de Obsidian Flavored Markdown: wikilinks, embeds, callouts, block IDs, propiedades, tags, highlights, math y mermaid. Valida o corrige una nota. Triggers: sintaxis obsidian, wikilink, callout, embed, block id, obsidian markdown, esto renderiza bien en obsidian, frontmatter obsidian."
+argument-hint: "[reference | check <archivo> | fix <archivo>]"
+category: "pkm"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit
+---
+
+# Obsidian Markdown - Sintaxis nativa
+
+Obsidian extiende CommonMark y GFM. Este skill cubre **solo las extensiones propias de Obsidian**: el markdown estándar (títulos, negrita, listas, tablas, código) se da por sabido. Adaptado de `kepano/obsidian-skills` al formato de este repo.
+
+Modo y archivo: `$ARGUMENTS`
+
+## Modos
+
+- **`reference`** (default): responder la duda de sintaxis con la tabla de abajo, sin tocar archivos.
+- **`check <archivo>`**: leer la nota y reportar qué no va a renderizar. Read-only.
+- **`fix <archivo>`**: corregir lo que `check` encontró. Pedí approval antes de escribir, mostrando el diff propuesto.
+
+## Links y embeds
+
+```markdown
+[[Nota]]                          link interno
+[[Nota|Texto visible]]            alias
+[[Nota#Titulo]]                   link a un heading
+[[Nota#^block-id]]                link a un bloque
+[[#Titulo en esta nota]]          link interno a la misma nota
+
+![[Nota]]                         embed de la nota completa
+![[Nota#Titulo]]                  embed de una seccion
+![[imagen.png|300]]               embed con ancho
+![[doc.pdf#page=3]]               embed de una pagina de PDF
+```
+
+Un block ID se define agregando `^mi-id` al final del párrafo. En listas y citas va en una línea aparte después del bloque.
+
+**`[[wikilinks]]` para lo interno, `[texto](url)` solo para URLs externas.** No es estilo: Obsidian actualiza los wikilinks cuando renombrás una nota dentro de la app, y no toca los markdown links.
+
+## Callouts
+
+```markdown
+> [!note]
+> Callout basico.
+
+> [!warning] Titulo propio
+> Con titulo custom.
+
+> [!faq]- Colapsado por default
+> El `-` lo colapsa, el `+` lo abre.
+```
+
+Tipos: `note`, `tip`, `info`, `warning`, `danger`, `bug`, `example`, `quote`, `success`, `failure`, `question`, `abstract`, `todo`. Un tipo inventado renderiza como `note` sin avisar, y ese es el error de callout más común.
+
+## Propiedades (frontmatter)
+
+```yaml
+---
+title: Mi nota
+date: 2026-07-27
+tags:
+  - proyecto
+  - activo
+aliases:
+  - Nombre alternativo
+cssclasses:
+  - custom
+---
+```
+
+`tags`, `aliases` y `cssclasses` son las tres propiedades que Obsidian entiende de forma nativa. El resto son campos propios y los consume Bases o Dataview.
+
+## Resto de la sintaxis propia
+
+```markdown
+#tag  #anidado/tag              tags inline (no pueden empezar con numero)
+==resaltado==                   highlight
+%%comentario%%                  invisible en lectura
+$e^{i\pi}+1=0$   y   $$...$$    math LaTeX inline y en bloque
+texto[^1]  /  ^[nota inline]    footnotes
+```
+
+Los bloques ` ```mermaid ` renderizan diagramas nativamente.
+
+## Qué revisa `check`
+
+| Check | Qué busca | Verdict |
+|---|---|---|
+| Tipo de callout | `> [!tipo]` con un tipo que no existe | FAIL: renderiza como `note` |
+| Links externos como wikilink | `[[https://...]]` | FAIL: no resuelve |
+| Links internos como markdown | `[texto](Nota.md)` dentro del vault | CONCERNS: se rompe al renombrar |
+| Frontmatter | Abre con `---` en la primera línea y cierra | FAIL si no cierra: Obsidian lo muestra como texto |
+| `tags` con `#` en frontmatter | `tags: [#foo]` | CONCERNS: el `#` no va en frontmatter |
+| Block IDs | Duplicados en la misma nota | FAIL: el link resuelve al primero |
+| Embeds de imagen | Ancho no numérico (`![[img.png|grande]]`) | CONCERNS: se ignora |
+| Espacios en `[[ Nota ]]` | Espacios internos al principio o final del target | CONCERNS: puede no resolver |
+
+Nota COMPLIANT cuando ninguna de estas falla.
+
+## Reglas
+
+- No reformatear la nota entera cuando el pedido es arreglar un detalle: `Edit` sobre citas textuales, no `Write` del archivo completo.
+- No convertir markdown links externos a wikilinks: los externos van como markdown link.
+- No inventar tipos de callout ni propiedades que Obsidian no reconoce.
+- Sin guiones largos en lo que agregues.
+
+## Handoff
+
+Si la duda era de vistas agregadas y no de sintaxis de nota, el skill correcto es `/obsidian-bases`; si era de un canvas, `/obsidian-canvas`. Cuando la nota queda COMPLIANT, seguí con el flujo que la produjo (`/zettel`, `/review-dump` o `/vault-clip`).

package/skills/pdf-generator/scripts/fill_inspect.py

@@ -12,6 +12,8 @@ allowed values (for checkboxes / dropdowns), and page number.
 Exit codes: 0 success, 1 bad args / file not found, 2 dep missing, 3 read error
 """
 
+from __future__ import annotations
+
 import argparse
 import json
 import sys

package/skills/pdf-generator/scripts/render_body.py

@@ -27,6 +27,8 @@ Block types:
 Exit codes: 0 success, 1 bad args/missing file, 2 missing dep, 3 render error
 """
 
+from __future__ import annotations
+
 import argparse
 import io
 import json

package/skills/personal-brand/SKILL.md

@@ -7,7 +7,7 @@ user-invocable: true
 allowed-tools: Read, Glob, Grep, Write, Edit
 ---
 
-# Personal Brand — Autoridad en LinkedIn para la búsqueda
+# Personal Brand - Autoridad en LinkedIn para la búsqueda
 
 Construís una marca personal en LinkedIn orientada a conseguir trabajo: un backlog **secuenciado** de ideas de post (ritmo 1/día) que construye autoridad y credibilidad *antes* de salir a hacer outreach, de modo que cuando escribas a un recruiter ya tengan contexto de quién sos.
 
@@ -15,25 +15,25 @@ Trabajás contra el **perfil maestro** (`01-Perfiles/`) y el rol/empresas objeti
 
 ## Los 4 pilares
 
-1. **Builder credibility** — qué construiste/entregaste, con resultados. Demuestra que hacés, no solo que sabés.
-2. **Lessons from current role** — aprendizajes concretos del trabajo actual/reciente (técnicos y de proceso).
-3. **POVs on your domain** — opiniones/tendencias de tu dominio. Te posiciona como alguien que piensa, no solo ejecuta.
-4. **Behind-the-scenes of the job search** — el viaje de la búsqueda (en su justa medida): genera cercanía y a veces atrae oportunidades directas.
+1. **Builder credibility** - qué construiste/entregaste, con resultados. Demuestra que hacés, no solo que sabés.
+2. **Lessons from current role** - aprendizajes concretos del trabajo actual/reciente (técnicos y de proceso).
+3. **POVs on your domain** - opiniones/tendencias de tu dominio. Te posiciona como alguien que piensa, no solo ejecuta.
+4. **Behind-the-scenes of the job search** - el viaje de la búsqueda (en su justa medida): genera cercanía y a veces atrae oportunidades directas.
 
 Ver `references/post-pillars.md` para ángulos, hooks y formatos por pilar.
 
 ## Modos
 
-### `plan` — Backlog de 90 ideas secuenciadas
+### `plan` - Backlog de 90 ideas secuenciadas
 1. Confirmar rol objetivo, empresas y los temas donde el usuario tiene autoridad real (del perfil maestro).
 2. Generar **90 ideas** repartidas en los 4 pilares. Cada idea = **hook + ángulo + formato** (texto, carrusel, lista, story, hot-take).
-3. **Secuenciar**: los primeros ~30 días priorizan pilares 1–3 (construir autoridad); recién después meter más del pilar 4 y empujar el outreach. La autoridad va antes que el pedido.
+3. **Secuenciar**: los primeros ~30 días priorizan pilares 1-3 (construir autoridad); recién después meter más del pilar 4 y empujar el outreach. La autoridad va antes que el pedido.
 4. Entregar como tabla/calendario (día → idea → pilar → formato).
 
-### `ideas <N>` — Lote de N ideas
+### `ideas <N>` - Lote de N ideas
 Generar N ideas frescas para un pilar o tema puntual, mismo formato hook+ángulo+formato.
 
-### `draft <idea>` — Escribir un post
+### `draft <idea>` - Escribir un post
 Convertir una idea en un post listo para publicar: hook fuerte en la primera línea, cuerpo escaneable, CTA o pregunta de cierre. Tono humano, sin clichés de LinkedIn ("I'm humbled to announce…").
 
 ## Principios
@@ -43,7 +43,7 @@ Convertir una idea en un post listo para publicar: hook fuerte en la primera lí
 - **Una idea por post.** Foco.
 - **Consistencia > perfección.** El plan asume ritmo sostenible; mejor 1/día simple que 1/semana elaborado.
 - **Autoridad antes que pedido.** No arranques pidiendo trabajo; primero aportá valor.
-- **Verdad.** Nada de logros inflados — la audiencia y los recruiters lo notan.
+- **Verdad.** Nada de logros inflados - la audiencia y los recruiters lo notan.
 
 ## Idioma