claude-code-arcane 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+# [2.1.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.0.0...v2.1.0) (2026-08-04)
+
+
+### Bug Fixes
+
+* **ci:** group concurrency by branch name so a push really runs once ([54a83b7](https://github.com/SebastianLuser/claude-code-arcane/commit/54a83b729c9a82213880cf02de0bf44098040d38))
+* **ci:** scope the concurrency group per event, not per branch ([1ce5273](https://github.com/SebastianLuser/claude-code-arcane/commit/1ce52739a7182f29b51af68b00b6164fc6911b72)), closes [#7](https://github.com/SebastianLuser/claude-code-arcane/issues/7)
+
+
+### Features
+
+* related notes, doc-count and python-floor guards, .base dashboard ([f4fe5c6](https://github.com/SebastianLuser/claude-code-arcane/commit/f4fe5c65deedf0ad247aaa31edfb2498183092e1))
+* **second-brain:** add a hot context cache, note maturity, and cross-project reads ([9b1669f](https://github.com/SebastianLuser/claude-code-arcane/commit/9b1669f2b9808d2815a653fa34acd62531274bd0))
+* **second-brain:** add Obsidian second brain profile ([882c836](https://github.com/SebastianLuser/claude-code-arcane/commit/882c83680efcb3d345888486423fad3d73f2d176))
+* **second-brain:** resolve paths by role, add ranked recall, cache the inventory ([f4c9c7c](https://github.com/SebastianLuser/claude-code-arcane/commit/f4c9c7c8bbf27a4388598cdec50ed9a1141bdf7a))
+* **second-brain:** who-writes-what classes, a code bridge, and sync rules ([03236d2](https://github.com/SebastianLuser/claude-code-arcane/commit/03236d20fdcee3aa55e1b26056021a0334c5497d))
+
 # [2.0.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v1.4.0...v2.0.0) (2026-07-27)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # Claude Code Arcane
 
-> **337 skills, 87 agents, 15 hooks and 20 rules for Claude Code — selective deploy by profile.**
+> **375 skills, 92 agents, 16 hooks and 25 rules for Claude Code — selective deploy by profile.**
 
 A configuration harness installable via `npx`. Pick a **profile** that matches your stack and only the relevant tools get installed into your project's `.claude/` directory.
 
@@ -194,6 +194,7 @@ Once installed, manage the installation from within a Claude Code session:
 | `+regulatory` | ISO 13485, GDPR, FDA, SOC 2, ISMS, QMS, MDR | 13 | regulatory |
 | `+job-hunt` | Job search end-to-end — master profile, ATS CV with verification, job scraping with dedup, LinkedIn, portfolio, cover letters, outreach, interview prep | 16 | — |
 | `+ecommerce` | Commerce end-to-end agnóstico de lenguaje — data model, checkout, inventario, órdenes, pagos, promociones, shipping/tax, listings, analytics, feeds, storefront, suscripciones | 12 | ecommerce |
+| `+second-brain` | Second brain en Obsidian — captura sin fricción, reviews diario/semanal/mensual, notas atómicas y hub files (PARA + Zettelkasten), búsqueda con ranking, caché de contexto entre sesiones, auditoría de salud del vault, sintaxis nativa (markdown, Bases, Canvas) | 14 | — |
 | `+self-improving` | Agent self-improvement and skill extraction | 2 | — |
 | `+statusline` | Claude Code status bar (branch, division, session info) | 0 | — |
 
@@ -348,11 +349,11 @@ claude-code-arcane/
 │   ├── manifest.ts            # Read/write arcane-manifest.json
 │   ├── types.ts               # TypeScript interfaces
 │   └── utils.ts               # Cross-platform helpers
-├── skills/                    # 333 skills (flat, one dir per skill)
+├── skills/                    # 375 skills (flat, one dir per skill)
 ├── profiles/                  # 29 profiles (YAML)
 ├── agents/                    # 13 dirs, 86+ agents (Markdown)
 ├── hooks/                     # 15 lifecycle hooks (Bash)
-├── rules/                     # 20 rules (Markdown)
+├── rules/                     # 25 rules (Markdown)
 ├── templates/                 # Gamedev templates
 ├── docs/                      # Documentation
 └── skills-selftest/           # QA framework

package/docs/SKILLS-CATALOG.md

@@ -1,6 +1,8 @@
 # Skills Catalog — Claude Code Arcane
 
-Catalogo completo de los 337 skills disponibles para proyectos consumidores. Organizados por division.
+Los 375 skills disponibles para proyectos consumidores, organizados por division.
+
+La tabla cubre 333: hay 42 skills instalables que todavia no estan catalogados aca. Un test de CI (`src/__tests__/doc-counts.test.ts`) verifica que estos numeros coincidan con el filesystem y que el header de cada seccion coincida con sus filas.
 
 ## Como ejecutar un skill
 
@@ -98,7 +100,7 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 
 ---
 
-## General (55 skills)
+## General (54 skills)
 
 | Skill | Descripcion | Uso |
 |-------|-------------|-----|
@@ -455,6 +457,27 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 
 ---
 
+## Second Brain (14 skills)
+
+| Skill | Descripcion | Uso |
+|-------|-------------|-----|
+| `/second-brain` | Entry point: crea o adopta el vault (PARA + Zettelkasten + hub files), escribe su CLAUDE.md y su cache hot.md, detecta plugins, conecta otros proyectos al mismo vault y rutea | `[setup\|adopt\|status\|next\|link]` |
+| `/brain-dump` | Captura sin friccion al dump del dia: sin tags, sin clasificar, sin decidir donde va | `[texto a capturar]` |
+| `/review-dump` | Procesa el dump: clasifica item por item con confirmacion, actualiza hubs, rutea tareas y crea el daily | `[today\|YYYY-MM-DD]` |
+| `/review-weekly` | Retrospectiva semanal: temas recurrentes, hilos abiertos y tareas hechas vs no hechas | `[current\|YYYY-Www\|YYYY-MM-DD]` |
+| `/review-monthly` | Retrospectiva mensual: patrones, logros con evidencia, semillas y salud del vault | `[current\|YYYY-MM]` |
+| `/zettel` | Nota atomica con el criterio de cuando una idea pasa de nota de proyecto a permanente | `[idea\|ruta#seccion\|dump YYYY-MM-DD]` |
+| `/hub-note` | Hub file (MOC) por entidad que importa: el tejido entre PARA y Zettelkasten | `[entidad] [--update]` |
+| `/vault-recall` | Busqueda con ranking (BM25, acentos plegados, expansion por alias) y notas relacionadas por vocabulario compartido, via indice cacheado | `<consulta> \| related <nota> [-n N]` |
+| `/vault-clip` | URL a nota limpia: contenido sin menus ni banners, con resumen propio y fuente | `<url> [--full\|--summary]` |
+| `/vault-audit` | Reporte de salud via script Python: huerfanas, links roto, stale, semillas que no crecieron, contradicciones, tag sprawl, nombres duplicados. Read-only | `[--vault <path>] [--stale-days N]` |
+| `/vault-tidy` | Aplica los arreglos del audit con approval item por item. Nunca borra, archiva | `[orphans\|broken\|duplicates\|tasks\|frontmatter\|archive\|all]` |
+| `/obsidian-markdown` | Sintaxis Obsidian: wikilinks, embeds, callouts, block IDs, propiedades. Valida o corrige una nota | `[reference\|check <archivo>\|fix <archivo>]` |
+| `/obsidian-bases` | Archivos .base: vistas, filtros, formulas y summaries. Incluye migracion desde Dataview | `[create <desc>\|explain <archivo>\|migrate <query>]` |
+| `/obsidian-canvas` | Archivos .canvas (JSON Canvas): nodos, grupos y edges con direccion y color | `[create <desc>\|explain <archivo>\|edit <archivo>]` |
+
+---
+
 ## E-Commerce (12 skills)
 
 | Skill | Descripcion | Uso |

package/docs/USER-GUIDE.md

@@ -2,7 +2,7 @@
 
 ## What is Arcane?
 
-Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It provides a curated library of **337 skills**, **87 agents**, **15 hooks**, and **20 rules** that you selectively deploy into any project. Instead of shipping everything to every project (wasting tokens and degrading performance), you pick a **profile** that matches your stack and only the relevant tools get installed.
+Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It provides a curated library of **375 skills**, **92 agents**, **16 hooks**, and **25 rules** that you selectively deploy into any project. Instead of shipping everything to every project (wasting tokens and degrading performance), you pick a **profile** that matches your stack and only the relevant tools get installed.
 
 ## Table of Contents
 
@@ -536,7 +536,7 @@ Yes, and it's recommended. This way everyone on the team gets the same Claude Co
 
 ### How many tokens does a profile consume?
 
-Each skill adds ~30-100 tokens to the system prompt. A typical base profile (20-30 skills) adds ~1-2k tokens. The core profile adds ~500 tokens. Compare that to loading all 333 skills, which is why selective deploy matters.
+Each skill adds ~30-100 tokens to the system prompt. A typical base profile (20-30 skills) adds ~1-2k tokens. The core profile adds ~500 tokens. Compare that to loading all 375 skills, which is why selective deploy matters.
 
 ### Why replace instead of merge on install?
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-arcane",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Skills, agents, hooks and rules for Claude Code — installable via npx arcane",
   "type": "module",
   "bin": {

package/profiles/second-brain.yaml

@@ -0,0 +1,37 @@
+name: second-brain
+description: "Second Brain — vault de Obsidian gestionado con Claude Code: captura sin friccion, reviews diario/semanal/mensual, notas atomicas y hub files (PARA + Zettelkasten), busqueda con ranking, captura web, auditoria de salud del vault y sintaxis nativa de Obsidian (markdown, Bases, Canvas)"
+type: addon
+
+skills:
+  - second-brain
+  - brain-dump
+  - review-dump
+  - review-weekly
+  - review-monthly
+  - zettel
+  - hub-note
+  - vault-recall
+  - vault-clip
+  - vault-audit
+  - vault-tidy
+  - obsidian-markdown
+  - obsidian-bases
+  - obsidian-canvas
+
+rules:
+  universal:
+    - vault-conventions
+  gamedev:
+    []
+
+agents:
+  []
+
+permissions:
+  allow:
+    - "Bash(python *vault_audit.py*)"
+    - "Bash(python3 *vault_audit.py*)"
+    - "Bash(python *vault_index.py*)"
+    - "Bash(python3 *vault_index.py*)"
+  deny:
+    []

package/rules/vault-conventions.md

@@ -0,0 +1,144 @@
+# Vault Conventions Rule (second brain en Obsidian)
+
+Reglas que gobiernan toda escritura dentro de un vault de Obsidian. Existen porque un agente que escribe notas sin restricciones degrada el vault mas rapido de lo que lo construye: linkea todo con todo, arrastra tareas en silencio y renombra archivos rompiendo `[[wikilinks]]`.
+
+Las rutas son relativas al vault (`--vault`, env `OBSIDIAN_VAULT`, o el directorio actual si contiene `.obsidian/`).
+
+## Cuando aplica
+
+- Cualquier skill del profile `second-brain` que cree o edite notas.
+- Cualquier escritura en un directorio que contenga `.obsidian/`, incluso desde otro skill.
+- NO aplica a los archivos de configuracion del vault (`.obsidian/**`): no se tocan nunca sin pedido explicito del usuario.
+
+## Quién escribe cada archivo
+
+Antes de tocar cualquier cosa, la pregunta es de quién es ese archivo. Hay tres clases y el permiso de escritura es distinto en cada una. Adaptado de la distinción **autorado / proyectado** de la base de conocimiento de producto de Educabot, que es la que hace que un agente y una persona escriban en el mismo repositorio sin pisarse.
+
+| Clase | Quién escribe | Qué puede hacer el agente | Ejemplos |
+|---|---|---|---|
+| **Autorado** | La persona. Cambia lento | **Nada sin approval.** Ni reformatear, ni "mejorar" | Dumps, notas atómicas, hubs, clips, proyectos, el `CLAUDE.md` del vault, la sección `## Reflexión` de los reviews |
+| **Sintetizado** | El agente, con approval, y queda como nota permanente | Proponer y escribir tras el OK. Idempotente: correr dos veces no duplica | Dailies, weeklies, monthlies, el `## Historial` de un hub |
+| **Proyectado** | El agente, sin preguntar. Derivado y descartable | Reescribir completo cuando corresponda | `hot.md`, el índice `.vault-index.json`, las vistas `.base` |
+
+Tres consecuencias que resuelven las dudas que aparecen en la práctica:
+
+- **Lo proyectado no se edita a mano.** Si el usuario lo edita, el próximo review lo pisa. Por eso `hot.md` lleva la advertencia adentro.
+- **Lo proyectado no es fuente de verdad.** Si contradice a una nota, la nota gana. Se puede borrar sin perder nada.
+- **Lo autorado no se toca ni para arreglarlo.** Si una nota del usuario tiene el frontmatter roto, se propone el arreglo; no se aplica solo. La excepción son las categorías que `/vault-tidy` aplica con approval item por item.
+
+Si no sabés en qué clase cae un archivo, es autorado. El default es no escribir.
+
+## El vault apunta, no copia
+
+Cuando algo ya tiene una fuente de verdad afuera, el vault guarda **el puntero y el porqué**, nunca una copia:
+
+| Contenido | Fuente de verdad | En el vault |
+|---|---|---|
+| Código y arquitectura | El repo | `repos:` en el frontmatter, y `codebases.md` con el path local |
+| Tickets, estados, sprints | Jira, ClickUp, Linear | Link, y la decisión que salió de ahí |
+| Diseños | Figma | Link en la nota del tema |
+| Artículos, papers | La web | El clip, con `source:` y **tu** resumen |
+
+Una copia se desactualiza en silencio y después hay dos verdades y ninguna gana. Lo que sí acumula el vault es lo que ninguna de esas fuentes tiene: **qué decidiste, por qué, y qué aprendiste**. Eso no vive en Jira ni en el código.
+
+## Resolución de rutas: roles, no carpetas
+
+Ningún skill escribe en una ruta literal. Escribe en un **rol**, y el `## Rutas` del `CLAUDE.md` del vault dice qué carpeta es ese rol en este vault. Es lo que hace que un vault adoptado con otra estructura funcione sin tocar los skills.
+
+| Rol | Qué contiene | Default del `setup` |
+|---|---|---|
+| `inbox` | captura cruda del día | `_inbox` |
+| `daily` | síntesis diaria | `Reflect/Daily` |
+| `weekly` | retrospectiva semanal | `Reflect/Weekly` |
+| `monthly` | balance mensual | `Reflect/Monthly` |
+| `atomic` | notas atómicas | `03_Resources` |
+| `hubs` | hub files por entidad | `Hubs` |
+| `projects` | proyectos con deadline | `01_Projects` |
+| `areas` | responsabilidades continuas | `02_Areas` |
+| `archive` | cerrado, nunca borrado | `04_Archive` |
+| `templates` | plantillas del usuario | `Templates` |
+
+Orden de resolución, sin excepciones:
+
+1. El `## Rutas` del `CLAUDE.md` del vault.
+2. Si el vault no lo declara, el default de la tabla, **avisándole al usuario que se está asumiendo**.
+3. Si el rol no existe en este vault (no todos tienen `areas`), preguntar antes de crear la carpeta.
+
+Los scripts reciben el mapeo por flag (`--role hubs=People`), nunca lo adivinan. **Si el `CLAUDE.md` del vault declara rutas distintas del default y un skill escribe en el default igual, eso es un bug del skill, no una preferencia.**
+
+## Las tres reglas de estructura
+
+### 1. Los links van hacia arriba, nunca hacia abajo
+
+Cada nota linkea a su contexto, no a su detalle:
+
+| Desde | Linkea a | Nunca a |
+|---|---|---|
+| Nota de `_inbox/` (dump) | hub files, proyectos, areas | otros dumps |
+| Daily | el dump del dia, notas creadas ese dia | otros dailies |
+| Weekly | los dailies de la semana | notas atomicas sueltas |
+| Monthly | los weeklies del mes | dailies |
+| Hub file | notas atomicas y proyectos del tema | dumps ni dailies |
+
+Sin esta regla el agente crea links bidireccionales en todas las direcciones y el grafo se vuelve ruido: cada nota apunta a todo y ninguna relacion significa nada. Los backlinks de Obsidian ya dan la direccion inversa gratis, no hay que escribirla.
+
+### 2. Ninguna nota se cierra sin al menos un `[[wikilink]]`
+
+Es la unica regla que previene las huerfanas de raiz. Si al terminar una nota no hay a que linkearla, esa es la senal de que falta un hub file: crear el hub (ver `/hub-note`) antes de cerrar la nota, o dejarla en `_inbox/` en vez de archivarla en `03_Resources/`.
+
+Excepcion: los dumps crudos de `_inbox/` pueden nacer sin links, porque los agrega `/review-dump`.
+
+### 3. Las tareas no hechas no se arrastran en silencio
+
+Una tarea abierta en el dump del lunes que sigue abierta el martes **se queda en el lunes**, marcada como cancelada (`- [-]`), y se crea de nuevo en el martes. No se mueve.
+
+No haber hecho algo un dia determinado es informacion. Arrastrar la tarea hacia adelante produce una lista limpia y una historia falsa.
+
+## Que no puede hacer el agente
+
+- **Nunca borrar una nota.** Mover a `04_Archive/` preservando el nombre. El borrado es decision del usuario, siempre.
+- **Nunca renombrar ni mover una nota sin approval explicito.** Rompe `[[wikilinks]]` en silencio: Obsidian solo los actualiza cuando el rename ocurre dentro de la app.
+- **Nunca editar en masa.** Una corrida toca las notas de esa corrida. Los cambios que afectan a muchas notas se proponen como plan y los aplica `/vault-tidy` con approval item por item.
+- **Nunca tocar `Templates/`** salvo pedido explicito: son el contrato del usuario, no del agente.
+- **Nunca reescribir la seccion de reflexion del usuario.** Los reviews sintetizan hechos; la interpretacion la escribe el usuario.
+
+## Contrato de frontmatter
+
+Todo campo que un skill escriba tiene que estar declarado en el `CLAUDE.md` del vault. Un campo que no esta en el contrato no se inventa: se propone y se agrega al contrato primero.
+
+Minimo por tipo de nota:
+
+```yaml
+---
+created: 2026-07-27        # ISO, nunca se reescribe
+type: daily                # daily | weekly | monthly | dump | atomic | hub | project | area | clip
+tags: []
+---
+```
+
+Los tipos con campos propios (`status` en proyectos, `source` en clips) los declara el skill que los crea.
+
+## Convenciones de escritura
+
+- Nada de guiones largos: si un texto generado trae em-dash o en-dash, normalizar a `-` antes de escribir.
+- `[[wikilinks]]` para todo lo interno, `[texto](url)` solo para URLs externas. Obsidian trackea renames de wikilinks, no de markdown links.
+- Fechas ISO (`YYYY-MM-DD`) en frontmatter y en nombres de archivo de notas periodicas.
+- Una idea por nota atomica. Si una nota necesita dos titulos de nivel `##` que no se relacionan, son dos notas.
+
+## La estructura no la sostiene este archivo
+
+Una convención que solo vive en un documento se muere en tres meses. Lo que la sostiene es lo que corre:
+
+| Convención | Qué la hace cumplir |
+|---|---|
+| Frontmatter completo, notas con al menos un link | El hook `PostToolUse` de `second-brain`, al escribir |
+| Huérfanas, links roto, nombres duplicados, semillas que no crecen | `/vault-audit`, cada vez que se corre |
+| Contradicciones sin resolver | `status: contested`, que el audit lista y el monthly mira |
+| Rutas por rol | El `## Rutas` del contrato, que los skills leen antes de escribir |
+| Tareas que no se arrastran | El paso de tareas de `/review-dump`, y `stale_open_tasks` en el audit |
+
+Si una regla nueva de este archivo no tiene una columna derecha, es una intención, no una regla. Antes de agregarla, preguntá qué la va a hacer cumplir.
+
+## Git como red de seguridad
+
+El vault deberia ser un repo git. Antes de una corrida que escribe varias notas (`/review-dump`, `/vault-tidy`), verificar que el arbol este limpio y avisar al usuario si no lo esta. Es lo que permite deshacer una corrida completa sin revisar nota por nota.

package/skills/brain-dump/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: brain-dump
+description: "Captura sin friccion al dump del dia en el vault de Obsidian: tareas, ideas, links, transcripciones. Sin tags, sin decidir donde va. Triggers: anota, capturar, brain dump, tirame esto al vault, apunta esto, agregar al inbox, dump del dia."
+argument-hint: "[texto a capturar]"
+category: "pkm"
+user-invocable: true
+allowed-tools: Read, Glob, Write, Edit
+---
+
+# Brain Dump - Captura sin fricción
+
+Agregás lo que el usuario te pasa al dump del día y te callás. Este skill existe para que capturar cueste cero: el momento en que el usuario tiene que pensar "¿dónde va esto?", el sistema ya falló.
+
+Contenido a capturar: `$ARGUMENTS`
+
+Aplica la rule `vault-conventions`.
+
+**Rutas por rol:** el destino se nombra por rol (`inbox`, `templates`), y la ruta real sale del `## Rutas` del `CLAUDE.md` del vault. Los defaults entre paréntesis solo aplican si el vault no declara otra cosa.
+
+## Pasos
+
+1. **Ubicar el vault.** Flag `--vault <path>`, env `OBSIDIAN_VAULT`, o el directorio actual si contiene `.obsidian/`. Si no hay vault, decirlo en una línea y ofrecer `/second-brain setup`. No inventar una carpeta.
+
+2. **Resolver el rol `inbox`.** Leer el `## Rutas` del `CLAUDE.md` del vault. Es lo único que hace falta leer del contrato acá, y cuesta una lectura: escribir en `_inbox/` cuando el vault usa otra carpeta deja la captura en un lugar que ningún review va a mirar. Si el vault no tiene `CLAUDE.md`, usar el default y avisar en la misma línea de confirmación.
+
+3. **Abrir el dump de hoy.** `<inbox>/YYYY-MM-DD dump.md` (default `_inbox/`) con la fecha de hoy. El dump se llama `YYYY-MM-DD dump.md` y no `YYYY-MM-DD.md` a propósito: el daily de ese día ya se llama `YYYY-MM-DD.md`, y dos archivos con el mismo nombre hacen que `[[2026-07-28]]` resuelva de forma impredecible en todo el vault. Es la colisión que el audit reporta como `ambiguous_names`, y sin el sufijo pasaría todos los días. Si el vault ya tiene dumps con el nombre viejo, seguir su convención y avisarlo, en vez de partir la serie en dos.
+
+   Si no existe, crearlo desde `<templates>/Dump.md` (default `Templates/`), o con el frontmatter mínimo `created`, `type: dump`, `tags: []` si el template no está.
+
+4. **Agregar el contenido al final**, una línea por cosa, sin reordenar ni reescribir lo que ya había:
+   - Lo que suena a tarea va como `- [ ] <texto>`. Lo que suena a idea, nota o link va como `- <texto>`.
+   - URLs sueltas se dejan crudas, con el título de la página al lado solo si el usuario lo dio. No abrir la URL: eso es `/vault-clip`.
+   - Se preserva la redacción del usuario. No corregís su ortografía ni su registro, no resumís, no traducís.
+
+5. **Si no vino contenido en `$ARGUMENTS`**, preguntar qué capturar en una sola línea y esperar. No abrir un cuestionario.
+
+6. **Confirmar en una línea** qué se agregó y a qué archivo. Nada más: el usuario está en medio de otra cosa.
+
+## Approval
+
+La invocación del skill es la aprobación para agregar al dump de hoy: pedir confirmación en cada captura destruiría el punto del skill. Los límites son estrictos en cambio para todo lo demás: **pedí approval explícito antes de escribir fuera del rol `inbox`**, antes de editar líneas que ya estaban en el dump, y antes de crear cualquier nota en los roles `atomic` o `hubs`. Clasificar es trabajo de `/review-dump`, no de acá.
+
+## Reglas
+
+- No clasificar, no taggear, no linkear, no crear notas nuevas. Nada de eso pasa en la captura.
+- No juzgar el contenido ni sugerir mejoras. Es un dump, no un borrador.
+- Nunca reescribir ni reordenar lo que ya estaba en el archivo: solo append.
+- Sin guiones largos en lo que agregues de tu parte.
+- Si el usuario captura algo que claramente es una tarea de un proyecto que existe, **igual va al dump**. La ruteada la hace el review, así el usuario nunca decide en el momento.
+
+## Handoff
+
+Captura COMPLETE cuando el contenido está en el dump del día. A la noche, o cuando el usuario quiera cerrar el día, el siguiente paso es `/review-dump` para clasificar todo lo capturado y generar el daily.

package/skills/hub-note/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: hub-note
+description: "Crea o actualiza un hub file (MOC) del vault: una nota por entidad que importa (persona, herramienta, concepto, empresa) que acumula conocimiento y conecta PARA con Zettelkasten. Triggers: hub file, MOC, mapa de contenido, nota de entidad, crear hub de, actualizar hub, nota de persona."
+argument-hint: "[entidad] [--update]"
+category: "pkm"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit
+---
+
+# Hub Note - Tejido conectivo del vault
+
+Un hub file es una nota por entidad que importa. No contiene conocimiento propio: contiene **el estado actual** de esa entidad y **los links** a todo lo que se sabe de ella. Es lo que hace que PARA (carpetas) y Zettelkasten (notas planas) convivan sin pelearse.
+
+Entidad: `$ARGUMENTS`
+
+Aplica la rule `vault-conventions`.
+
+**Rutas por rol:** los destinos se nombran por rol y la ruta real de cada uno sale del `## Rutas` del `CLAUDE.md` del vault (leelo antes de escribir). Los defaults entre paréntesis solo aplican si el vault no declara otra cosa.
+
+## Fase 1 - Decidir si la entidad merece hub
+
+El criterio es la recurrencia, no la importancia: **la entidad apareció en tres dumps o notas distintas**. Antes de eso es una mención, y un hub por mención produce cientos de notas de una línea que nadie visita.
+
+1. Buscar la entidad con `/vault-recall` si está disponible, o `Grep` en los roles `inbox`, `daily` y `atomic` (defaults `_inbox/`, `Reflect/Daily/`, `03_Resources/`) por el nombre y sus variantes.
+2. Contar apariciones y reportarlas con los links.
+3. Si hay menos de tres, decirlo y proponer esperar. Si el usuario quiere el hub igual (una persona nueva en el equipo, un proyecto que arranca), se crea: la anticipación es un motivo válido, la duda no.
+
+Verdict: PASS si hay tres apariciones o una razón explícita del usuario.
+
+## Fase 2 - Buscar el hub existente
+
+`Glob` en `<hubs>` (default `Hubs/`) y revisar los `aliases` del frontmatter de los hubs que haya. Las entidades llegan con nombres distintos ("Educabot", "educabot", "EB"): si ya existe un hub para la entidad bajo otro nombre, **actualizar ese** y agregar el nombre nuevo a `aliases`. Nunca crear un segundo hub para la misma entidad: es el duplicado más caro del vault, porque parte el conocimiento en dos lugares que nadie reconcilia.
+
+## Fase 3 - Escribir
+
+Con approval, crear o actualizar el hub en `<hubs>` (default `Hubs/`) desde `<templates>/Hub.md`.
+
+Al **crear**:
+- Título: el nombre canónico de la entidad. Las variantes van a `aliases`.
+- Una o dos líneas de qué es y por qué tiene nota propia.
+- `## Estado actual`: lo que hay que saber hoy.
+- `## Notas`: links a las notas atómicas y proyectos del tema que ya existan (los que encontraste en la fase 1).
+- `## Historial`: una línea por aparición relevante, formato `- YYYY-MM-DD - qué pasó`, lo más nuevo arriba.
+- `status`: `seed` al crearlo, `provisional` cuando ya acumuló contenido. Un hub que el usuario mantiene al día puede quedar `evergreen`, pero lo marca él.
+- `repos:` si la entidad tiene código (una herramienta propia, un proyecto, un servicio). Es el puente al repo, y se traduce a path local en `codebases.md` del vault. **No copies arquitectura al hub:** el hub dice qué es y por qué, el repo dice cómo está hecho, y el que copia se desactualiza.
+
+Al **actualizar** (`--update`, o cuando el hub ya existe):
+- Agregar la entrada nueva al `## Historial`, sin duplicar una que ya esté con la misma fecha y el mismo contenido.
+- **`## Estado actual` se reescribe, no se acumula.** Es la sección que responde "qué sé hoy de esto"; si se convierte en un log, el hub deja de servir para lo único que sirve. Lo que se reemplaza y sigue siendo relevante baja al historial.
+- `## Notas`: agregar los links nuevos.
+
+## Fase 4 - Conectar
+
+- El hub linkea hacia las notas atómicas y los proyectos. Los dumps y dailies linkean **hacia** el hub. El hub no linkea a dumps ni a dailies: son registro, no conocimiento, y llenan el hub de ruido en un mes.
+- Si el hub cubre un tema amplio y ya pasó las 30 o 40 entradas en `## Notas`, proponer partirlo en sub-hubs por subtema. Un hub que nadie puede leer de arriba a abajo dejó de ser un mapa.
+
+Hub COMPLETE cuando tiene estado actual, al menos un link saliente, y las apariciones encontradas quedaron en el historial.
+
+## Reglas
+
+- Un hub por entidad. Los alias van al frontmatter, no a un hub nuevo.
+- El hub no acumula conocimiento propio: si querés explicar una idea, es una nota atómica (`/zettel`) linkeada desde acá.
+- Nunca borrar entradas del historial: si algo dejó de ser cierto, se agrega la entrada nueva.
+- Sin guiones largos.
+
+## Handoff
+
+Con el hub listo, el siguiente paso es `/zettel` para las ideas del tema que todavía no tienen nota propia, o volver a `/review-dump` si esto salió procesando el día. `/vault-audit` va a usar los hubs para distinguir una huérfana real de una nota que simplemente todavía no fue linkeada.

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.