claude-code-arcane 2.0.0 → 2.2.0

package/skills/music-composition/references/harmony.md

@@ -0,0 +1,82 @@
+# Armonía
+
+## Armonía funcional
+
+Tres funciones, y todo lo demás es sustitución o adorno:
+
+| Función | Grados (mayor) | Efecto |
+|---|---|---|
+| **Tónica** | I, vi, iii | Reposo, llegada |
+| **Subdominante** | IV, ii | Salida, preparación |
+| **Dominante** | V, vii° | Tensión, exige resolución |
+
+El movimiento fuerte es subdominante → dominante → tónica. Todo lo demás es demorar, sustituir o negar esa expectativa.
+
+**Ritmo armónico** — la velocidad de cambio de acorde es una palanca independiente de la progresión. La misma secuencia a un acorde por compás vs dos por compás cambia la urgencia sin cambiar una nota.
+
+## Cadencias
+
+| Cadencia | Movimiento | Efecto |
+|---|---|---|
+| Auténtica perfecta | V → I, con tónica en soprano y bajo | Cierre total |
+| Auténtica imperfecta | V → I invertido o sin tónica arriba | Cierre débil, sigue |
+| Plagal | IV → I | Reposo sin tensión previa; sabor modal/himno |
+| Semicadencia | → V | Pausa abierta, pregunta |
+| Rota | V → vi | Sorpresa, evita el cierre esperado |
+| Suspendida (picardía inversa) | resolución a menor donde se esperaba mayor | Ensombrece |
+
+## Armonía modal
+
+Cuando la progresión no quiere funcionalidad, el modo aporta color por su grado característico:
+
+| Modo | Grado característico | Carácter |
+|---|---|---|
+| Jónico | — | Neutro, brillante |
+| Dórico | ♮6 (sobre menor) | Menor sin tragedia; folk, aventura |
+| Frigio | ♭2 | Tensión oscura, MENA/flamenco |
+| Lidio | ♯4 | Suspensión luminosa, asombro |
+| Mixolidio | ♭7 | Rock/folk, menos gravedad que jónico |
+| Eólico | ♭6 natural | Menor estándar |
+| Locrio | ♭2 y ♭5 | Inestable, casi inusable como centro |
+
+En modal, evitar el V mayor: reintroduce función dominante y colapsa el modo a mayor/menor.
+
+## Armonía cromática
+
+- **Acordes prestados** — tomar del menor paralelo en un contexto mayor (♭VI, ♭VII, iv). Ensombrece sin modular
+- **Dominantes secundarias** — V/x tonicaliza cualquier grado. `C - E7 - Am` hace de Am un centro momentáneo
+- **Sustitución tritonal** — reemplazar V7 por el ♭II7. `G7 → D♭7` antes de C: mismo tritono, bajo cromático
+- **Napolitana (♭II)** — color dramático de aproximación a la dominante
+- **Acordes de sexta aumentada** — resolución cromática doble hacia V, muy tensa
+
+## Modulación
+
+De más suave a más abrupta:
+
+1. **Directa a tonalidad cercana** (relativo, dominante, subdominante): casi imperceptible
+2. **Por pivote** — un acorde común a las dos tonalidades reinterpretado. La técnica más limpia
+3. **Por dominante secundaria** — introducir el V de la nueva tonalidad
+4. **Cromática por bajo** — mover el bajo por semitonos hasta el nuevo centro
+5. **Enarmónica** — reinterpretar un acorde ambiguo (disminuido, sexta aumentada) hacia otro lado
+6. **Truncada / directa lejana** — cortar y arrancar en la nueva tonalidad. Efecto de corte cinematográfico
+
+Para juegos, la modulación por pivote es la única que sobrevive a un cambio de estado en tiempo real sin sonar a error.
+
+## Voice leading
+
+- Mover cada voz lo mínimo posible; la conducción suave es lo que hace que una progresión "funcione"
+- Resolver las tensiones: 7ª baja por grado, 4ª suspendida baja a 3ª
+- Evitar 5ªs y 8ªs paralelas entre voces exteriores en contexto tonal tradicional (en pop/rock son idiomáticas)
+- Evitar el salto de la voz más aguda junto con el bajo en la misma dirección al llegar a una cadencia
+- Doblar la tónica antes que la 5ª, y la 5ª antes que la 3ª
+
+## Reharmonización
+
+Palancas, de menor a mayor impacto:
+
+1. Cambiar inversiones — mismo acorde, bajo distinto
+2. Agregar extensiones (7, 9, 11, 13) — color sin cambiar función
+3. Sustituir por función equivalente — I → vi, V → iii
+4. Insertar dominantes secundarias entre acordes existentes
+5. Cambiar el modo del acorde — mayor por menor
+6. Reemplazar la progresión entera manteniendo la melodía: cada nota melódica admite varios acordes

package/skills/music-composition/references/melody.md

@@ -0,0 +1,48 @@
+# Melodía
+
+## Qué hace que una melodía se pegue
+
+Cuatro propiedades, y ninguna es "ser linda":
+
+1. **Perfil reconocible** — la silueta (sube, se sostiene, cae) es identificable sin el ritmo
+2. **Un gesto memorable** — un salto, una nota fuera de la escala, una síncopa. Un solo evento distintivo, no cinco
+3. **Repetición con variación** — el oído necesita reconocer antes de que le interese lo nuevo
+4. **Relación clara con la armonía** — las notas fuertes caen en tiempos fuertes y son consonantes o tensiones que resuelven
+
+Si una melodía no se pega, casi siempre falta el punto 2: es fluida, correcta y sin ningún evento que el oído pueda agarrar.
+
+## Construcción
+
+**Grados de escala, no notas.** Escribir `5 - 3 - 2 - 1` en vez de `G - E - D - C` la hace portable y expone la estructura.
+
+**Balance salto/grado.** Melodía toda por grados conjuntos: suave y anodina. Toda por saltos: instrumental, difícil de cantar. La proporción típica en música vocal memorable es mayoría de grados con 1-2 saltos ubicados en el punto de mayor interés.
+
+**Clímax único.** La nota más aguda debería aparecer una vez, y tarde. Si el punto alto llega en el compás 2, no queda a dónde ir.
+
+**Registro como recurso finito.** Cada octava que subís es un recurso que se gasta. Guardá el registro alto para el momento que lo necesita.
+
+## Desarrollo motívico
+
+Un motivo es una célula de 2-5 notas. Las transformaciones, de más a menos reconocible:
+
+| Transformación | Qué hace |
+|---|---|
+| **Repetición literal** | Establece |
+| **Secuencia** | Mismo motivo, otra altura. La herramienta más eficiente |
+| **Transposición diatónica** | Igual pero adaptado a la escala; cambia intervalos |
+| **Inversión** | Espeja los intervalos. Mismo ADN, otro carácter |
+| **Retrogradación** | Al revés. Reconocible solo si el motivo es rítmicamente distintivo |
+| **Aumentación / disminución** | Duplicar o dividir las duraciones. Aumentación = épico; disminución = urgencia |
+| **Fragmentación** | Quedarse con un trozo y repetirlo. Genera desarrollo/tensión |
+| **Ornamentación** | Rellenar con notas de paso. Cuidado: diluye |
+
+En música de juego, la aumentación y la fragmentación de un mismo motivo son la forma más barata de tener 4 variantes de un tema con una sola idea.
+
+## Estructura de frase
+
+- **Antecedente / consecuente** — 4+4 compases: la primera termina abierta (semicadencia), la segunda cierra. El patrón de pregunta-respuesta más usado
+- **Sentence** — presentación (2), continuación con fragmentación (2), cadencia (4)
+- **Frases asimétricas** (3, 5, 7 compases) — inquietan, útiles para tensión
+- **Elisión** — la última nota de una frase es la primera de la siguiente. Elimina la respiración, encadena
+
+**Prosodia (si hay letra):** las sílabas acentuadas caen en tiempos fuertes y en notas largas. Una melodía que pelea con el acento natural de la palabra suena mal aunque la armonía sea perfecta. Las vocales abiertas soportan notas agudas y largas; las cerradas no.

package/skills/music-composition/references/orchestration.md

@@ -0,0 +1,69 @@
+# Orquestación
+
+## Rangos y carácter
+
+Rangos prácticos (no extremos virtuosos). El **carácter cambia por registro** en el mismo instrumento — es lo que más se ignora.
+
+| Instrumento | Rango práctico | Registro grave | Registro agudo |
+|---|---|---|---|
+| Flauta | C4 – C7 | Aireado, débil, se tapa | Brillante, penetrante |
+| Clarinete | D3 – C6 | Oscuro, cálido, único | Estridente si se fuerza |
+| Oboe | B♭3 – G6 | Nasal, presente | Tenso |
+| Fagot | B♭1 – E5 | Sombrío, cómico | Vulnerable, expresivo |
+| Corno | F2 – F5 | Noble, difuso | Heroico, esfuerzo audible |
+| Trompeta | E3 – C6 | Sólido | Brillante, corta cualquier textura |
+| Trombón | E2 – F4 | Grave, potente | Cantabile |
+| Violín | G3 – E7 | Cálido (cuerda G) | Brillante; muy agudo = tensión |
+| Viola | C3 – E6 | Ronco, melancólico | Delgado |
+| Cello | C2 – C6 | Profundo | El registro más expresivo de la orquesta |
+| Contrabajo | E1 – G4 | Fundamento | Raro, tenso |
+| Voz (soprano) | C4 – A5 | Débil | Potente, esfuerzo audible |
+| Voz (barítono) | A2 – F4 | Cómodo | Intenso |
+
+## Densidad de arreglo
+
+**La regla que resuelve el 80% de los problemas: menos elementos, mejor definidos.**
+
+| Nivel | Elementos simultáneos | Uso |
+|---|---|---|
+| Íntimo | 1-2 | Momentos de máxima atención |
+| Cámara | 3-5 | Estándar de gameplay sostenido |
+| Pleno | 6-10 | Clímax |
+| Tutti | todo | Una vez, y corto |
+
+En música de juego, el nivel de densidad es la palanca adaptativa más eficiente: subir y bajar capas sin cambiar el material.
+
+## Voicing y textura
+
+- **Espaciado natural** — intervalos amplios abajo, cerrados arriba. Copia la serie armónica; suena limpio automáticamente
+- **No apilar en el mismo registro** — cuatro instrumentos entre C4 y C5 producen barro. Separar por octavas
+- **Doblar con intención** — al unísono para peso, a la octava para brillo, en 3ªs/6ªs para dulzura. Doblar todo es no doblar nada
+- **Registro medio saturado** — 500 Hz-2 kHz es donde vive el diálogo. En un juego, la música debería *dejar ese rango relativamente libre* si hay VO simultáneo (ver `/audio-mix`)
+
+## Combinaciones que funcionan
+
+| Combinación | Efecto |
+|---|---|
+| Cello + corno (unísono) | Calidez con peso |
+| Clarinete grave + viola | Oscuridad ambigua |
+| Flauta + violín (octava) | Brillo aireado |
+| Pizzicato + arpa/mallets | Puntillismo, curiosidad |
+| Cuerdas con sordina + coro suave | Distancia, memoria |
+| Trompas en 5ªs abiertas | Épica; cliché si se abusa |
+| Solo + silencio | Máxima atención |
+
+## Escritura coral / vocal
+
+- Rango cómodo, no extremo: la tesitura sostenida importa más que la nota más alta
+- Voice leading estricto: las voces internas se mueven lo mínimo
+- Texto inteligible pide notas más largas y registro medio
+- Vocales abiertas (a, o) para agudos y notas largas; cerradas (i, u) suenan tensas arriba
+
+## Producción-aware
+
+Si el material va a un mix con SFX y diálogo encima:
+
+- Dejar espacio en 500 Hz-2 kHz cuando puede haber VO
+- El sub (20-60 Hz) suele estar reservado a impactos — no llenarlo con música
+- Los transientes agudos compiten con feedback de UI: si el arreglo tiene mucho hi-hat/percusión brillante, el UI se pierde
+- Arreglos densos sobreviven mal a la compresión lossy de plataforma: el detalle en 6-20 kHz es lo primero que se va

package/skills/music-composition/references/rhythm-groove.md

@@ -0,0 +1,49 @@
+# Ritmo y Groove
+
+## Qué es el groove
+
+La relación entre una grilla implícita y dónde caen los eventos reales. Sin grilla no hay groove; sin desvío tampoco.
+
+Tres capas independientes:
+
+1. **Pulso** — el tempo y su subdivisión
+2. **Patrón** — qué subdivisiones se atacan
+3. **Feel** — cuánto se corren los ataques respecto de la grilla, y cómo se acentúan
+
+Un patrón correcto con feel plano suena a máquina. El mismo patrón con los backbeats 8-15 ms atrasados y acentuados suena a banda.
+
+## Recursos rítmicos
+
+| Recurso | Qué hace |
+|---|---|
+| **Síncopa** | Acentuar una subdivisión débil. El motor de casi todo groove popular |
+| **Anticipación** | Adelantar un ataque medio pulso antes del tiempo fuerte |
+| **Hemiola** | Agrupar 3 donde el metro dice 2 (o al revés). Tensión sin cambiar tempo |
+| **Desplazamiento** | Correr un patrón entero N subdivisiones. Mismo material, otro lugar |
+| **Aumentación / disminución** | Duplicar o partir las duraciones del patrón |
+| **Silencio en el downbeat** | El recurso más fuerte y el menos usado |
+| **Polirritmia** | Dos ciclos de distinta longitud simultáneos (3:2, 4:3). El compuesto se repite cada MCM |
+| **Cross-rhythm** | El acento contradice el metro sostenidamente |
+
+## Feel y microtiming
+
+- **Swing** — la primera corchea del par se alarga. Cuantificable como ratio (50:50 recto, ~60:40 swing suave, 66:33 swing fuerte, hasta tresillo)
+- **Laid back** — atacar unos ms después de la grilla. Sensación de relajación, peso
+- **Push** — atacar antes. Urgencia, ansiedad
+- **Flam** — dos instrumentos casi al unísono, corridos unos ms. Engorda el ataque
+
+Un desvío de 10-30 ms es feel. Arriba de ~50 ms se percibe como error o como otra subdivisión.
+
+## Métricas impares
+
+- **5/4, 7/8** — se sienten como agrupaciones asimétricas (5 = 3+2 o 2+3; 7 = 2+2+3, 3+2+2...). La agrupación importa más que el número
+- **Métrica mixta** — alternar compases. Funciona si el patrón de alternancia es reconocible
+- **Metro aditivo** — construir por células (2+2+3) en vez de dividir el compás
+
+Para juegos, las métricas impares complican la sincronización de música adaptativa: los sync points en compás/beat asumen un metro estable. Si el metro cambia, definir los puntos de transición en cues explícitos.
+
+## Groove en el arreglo
+
+- **Interlock** — cada instrumento ocupa subdivisiones que los otros dejan libres. El groove emerge del conjunto, no de una parte
+- **Densidad como dinámica** — más subdivisiones atacadas = más energía, sin subir volumen
+- **Espacio** — el groove vive en los silencios. Un patrón con todas las subdivisiones llenas no groovea, machaca

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