claude-code-arcane 1.4.0 → 2.1.0

package/CHANGELOG.md

@@ -1,3 +1,58 @@
+# [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)
+
+
+* refactor(job-scrape)!: port both search CLIs from TypeScript to Python ([4a30a3e](https://github.com/SebastianLuser/claude-code-arcane/commit/4a30a3e7b30cbf616d01b860620172c602e5c6cf))
+
+
+### Bug Fixes
+
+* **cv-ats-export:** tell a missing verify_pdf.py apart from a missing pypdf ([f2b907e](https://github.com/SebastianLuser/claude-code-arcane/commit/f2b907e4f844725abe2b967941cef78d5fb98a0d))
+* **installer:** skip Python bytecode when copying skill assets ([525967d](https://github.com/SebastianLuser/claude-code-arcane/commit/525967d0270058b9cb5967c932a4969b23e4ea27))
+* **job-scrape:** accept share-button LinkedIn URLs in detail ([7f874e7](https://github.com/SebastianLuser/claude-code-arcane/commit/7f874e71007214540c5814561f8c5e9d46848cea))
+* **job-scrape:** read published dates as UTC in the jobage filter ([fa8e4d7](https://github.com/SebastianLuser/claude-code-arcane/commit/fa8e4d73e68fb1b3f8071cbdd15b1da53882d6e2))
+
+
+### Features
+
+* **cv-ats-export:** add ATS text-layer verification to PDF export ([dd79cc9](https://github.com/SebastianLuser/claude-code-arcane/commit/dd79cc966f88fc3e2ab38a8ebfcc1b51f4f1ad5f))
+* **job-hunt:** adopt extended application-state vocabulary and route to new skills ([4a39add](https://github.com/SebastianLuser/claude-code-arcane/commit/4a39add45301841625581ad4a42bb54442c51a8f))
+* **job-scrape:** confirm the LinkedIn ToS warning before running the CLIs ([294d905](https://github.com/SebastianLuser/claude-code-arcane/commit/294d9054b8c1014bde5babdce928da6d61570102))
+* **profiles:** add job-search tooling suite to job-hunt profile ([b4b061a](https://github.com/SebastianLuser/claude-code-arcane/commit/b4b061a8d724a2f9b4e94c40e83890d564ee9fd8))
+* **rules:** add drafter-reviewer rule for CV and cover review ([8467c38](https://github.com/SebastianLuser/claude-code-arcane/commit/8467c38b2b0e7af98838c3a4d91c3bb0dd36b8c4))
+* **skills:** add job-aplicar, job-outcome and job-upskill skills ([0401ca7](https://github.com/SebastianLuser/claude-code-arcane/commit/0401ca7e0c79b9e619ad064bb726a31d646b3fd3))
+* **skills:** add job-scrape skill with bundled linkedin/getonbrd CLIs ([562bd7b](https://github.com/SebastianLuser/claude-code-arcane/commit/562bd7bd261567efcfaaa17c871f80e47a3f0824))
+
+
+### Performance Improvements
+
+* **job-scrape:** add --brief to trim JD text from GetOnBoard search ([f2309e5](https://github.com/SebastianLuser/claude-code-arcane/commit/f2309e59ffd670894829a0730763d71733e2bffd))
+
+
+### BREAKING CHANGES
+
+* the CLI paths changed from
+scripts/<portal>-search/cli.ts to scripts/<portal>_search.py, and the profile's
+Bash permissions moved from node to python. Reinstall the job-hunt profile.
+
+Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
+
 # [1.4.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v1.3.0...v1.4.0) (2026-06-22)
 
 

package/README.md

@@ -1,6 +1,6 @@
 # Claude Code Arcane
 
-> **333 skills, 87 agents, 15 hooks and 19 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.
 
@@ -192,8 +192,9 @@ Once installed, manage the installation from within a Claude Code session:
 | `+finance` | Investment analysis, financial modeling, SaaS metrics | 3 | business |
 | `+marketing` | Content, growth, SEO/CRO, strategy, analytics | 44 | marketing |
 | `+regulatory` | ISO 13485, GDPR, FDA, SOC 2, ISMS, QMS, MDR | 13 | regulatory |
-| `+job-hunt` | Job search end-to-end — master profile, ATS CV, LinkedIn, portfolio, cover letters, outreach, interview prep | 12 | — |
+| `+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/                     # 19 rules (Markdown)
+├── rules/                     # 25 rules (Markdown)
 ├── templates/                 # Gamedev templates
 ├── docs/                      # Documentation
 └── skills-selftest/           # QA framework

package/dist/cli.js

@@ -117,9 +117,11 @@ function getPackageRoot() {
   const thisFile = fileURLToPath(import.meta.url);
   return path2.resolve(path2.dirname(thisFile), "..");
 }
+var COPY_SKIP = /* @__PURE__ */ new Set(["__pycache__", ".pytest_cache"]);
 function copyDirSync(src, dest) {
   fs2.mkdirSync(dest, { recursive: true });
   for (const entry of fs2.readdirSync(src, { withFileTypes: true })) {
+    if (COPY_SKIP.has(entry.name) || entry.name.endsWith(".pyc")) continue;
     const srcPath = path2.join(src, entry.name);
     const destPath = path2.join(dest, entry.name);
     if (entry.isDirectory()) {

package/docs/SKILLS-CATALOG.md

@@ -1,6 +1,8 @@
 # Skills Catalog — Claude Code Arcane
 
-Catalogo completo de los 333 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 |
 |-------|-------------|-----|
@@ -432,7 +434,7 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 
 ---
 
-## Job Hunt (12 skills)
+## Job Hunt (16 skills)
 
 | Skill | Descripcion | Uso |
 |-------|-------------|-----|
@@ -443,6 +445,10 @@ Desde cualquier proyecto que tenga Arcane configurado, escribi `/` seguido del n
 | `/linkedin-optimize` | Optimiza LinkedIn: headline, About, experiencia con KPIs, keywords, value prop, pitch 30s | `[section\|full]` |
 | `/portfolio-site` | Genera/actualiza portfolio web desde el source-of-truth | `[sync\|scaffold] [repo\|--new]` |
 | `/job-search` | Busca, scorea y prioriza ofertas + plan de busqueda de 7 dias | `[search <query>\|score <url>\|plan]` |
+| `/job-scrape` | Busca ofertas (CLIs LinkedIn + GetOnBoard bundleados) con dedup entre corridas, scorea y ofrece crear notas | `[perfil] [--jobage N]` |
+| `/job-aplicar` | Pipeline completo de una postulacion: fit, CV custom, cover, review, PDF verificado y dashboard | `<url\|nota>` |
+| `/job-outcome` | Registra resultado/avance de una aplicacion y actualiza nota + dashboard | `[empresa]` |
+| `/job-upskill` | Gaps de skills agregados de las aplicaciones + plan de estudio con recursos reales | `[url\|nota]` |
 | `/cover-letter` | Cover letters y mensajes de aplicacion concisos y custom | `[application\|company + role]` |
 | `/cold-outreach` | Mensajes en frio a recruiters/hiring managers + follow-ups post-aplicacion | `[contact\|recruiter + company]` |
 | `/interview-prep` | Prep de entrevista: research, banco de preguntas, respuestas STAR, red flags | `[application\|company + role + round]` |
@@ -451,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 **333 skills**, **87 agents**, **15 hooks**, and **19 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/docs/coding-standards.md

@@ -18,6 +18,32 @@ Las rules path-scoped específicas viven en `.claude/rules/`.
 
 ---
 
+## Elección de lenguaje en este repo
+
+El lenguaje lo dicta **el contexto de ejecución**, no la preferencia. Hay cuatro contextos y uno solo por cada uno:
+
+| Contexto | Lenguaje | Por qué | Garantía en CI |
+|---|---|---|---|
+| Installer (`src/`) | **TypeScript** | Es el paquete npm publicado: el único código con build (`tsup`) y typechecker | `npm run build`, `tsc --noEmit`, `vitest` |
+| Hooks de lifecycle (`hooks/`, `skills/*/hooks/`) | **Bash** | Claude Code los invoca por path, sin intérprete de por medio | `bash -n` sobre todos |
+| Scripts de skill (`skills/*/scripts/`) | **Python 3, solo stdlib** | Se copian al proyecto del usuario y corren ahí: sin build, sin `package.json`, sin `node_modules` | Specs en `tests/` (ver Testing) |
+| Templates (`*/templates/`) | **El del proyecto destino** | Son contenido que se emite al proyecto del usuario; el repo nunca los ejecuta | N/A |
+
+**TypeScript fuera de `src/` no es una elección de lenguaje: es un requisito de runtime disfrazado.** Sin build step, un `.ts` solo corre con el type stripping nativo de Node 24+, que la matriz de CI (20 y 22) no cubre. Si el script tiene que correr en la máquina del usuario, es Python.
+
+**Dependencias opcionales:** permitidas solo con degradación explícita. Referencia: `cv-ats-export` usa `pypdf` si está y reporta `[ATS SKIP]` si no, sin romper el export.
+
+### Escotilla de escape
+
+Otro lenguaje **únicamente cuando una dependencia obligatoria lo impone** — nunca por gusto ni por familiaridad. Requiere una línea de justificación en el SKILL.md del skill. Los dos casos vigentes:
+
+- `pdf-generator/scripts/render_cover.js` → Node, porque **Playwright es una librería de Node**.
+- `docx-generator/scripts/` (`.cs`, `.slnx`, `setup.ps1`) → .NET, porque **vendorea un proyecto .NET** (MiniMaxAIDocx); el `.ps1` es su setup en Windows.
+
+Si podés hacerlo con la stdlib de Python, la escotilla no aplica.
+
+---
+
 ## Naming
 
 - **Variables/funciones:** camelCase (JS/TS/Java/C#) o snake_case (Python/Rust) o PascalCase (Go exports)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-arcane",
-  "version": "1.4.0",
+  "version": "2.1.0",
   "description": "Skills, agents, hooks and rules for Claude Code — installable via npx arcane",
   "type": "module",
   "bin": {
@@ -22,6 +22,7 @@
     "dev": "tsup src/cli.ts --format esm --target node20 --watch",
     "test": "vitest run",
     "test:watch": "vitest",
+    "test:skills": "python -m unittest discover -s tests -p \"test_*.py\"",
     "prepublishOnly": "npm run build",
     "release": "semantic-release"
   },

package/profiles/job-hunt.yaml

@@ -1,5 +1,5 @@
 name: job-hunt
-description: "Job Hunt — busqueda laboral end-to-end: perfil maestro, CV ATS, LinkedIn, portfolio, cover letters, outreach a recruiters, scoring de ofertas y prep de entrevistas"
+description: "Job Hunt — busqueda laboral end-to-end: perfil maestro, CV ATS con verificacion, scraping de ofertas con dedup, pipeline de postulacion, LinkedIn, portfolio, cover letters, outreach a recruiters, scoring de ofertas, gaps/upskill y prep de entrevistas"
 type: addon
 
 skills:
@@ -10,6 +10,10 @@ skills:
   - linkedin-optimize
   - portfolio-site
   - job-search
+  - job-scrape
+  - job-aplicar
+  - job-outcome
+  - job-upskill
   - cover-letter
   - cold-outreach
   - interview-prep
@@ -18,7 +22,7 @@ skills:
 
 rules:
   universal:
-    []
+    - drafter-reviewer
   gamedev:
     []
 
@@ -29,7 +33,13 @@ permissions:
   allow:
     - "Bash(python *cv_export.py*)"
     - "Bash(python3 *cv_export.py*)"
+    - "Bash(python *verify_pdf.py*)"
+    - "Bash(python3 *verify_pdf.py*)"
     - "Bash(python *network_map.py*)"
     - "Bash(python3 *network_map.py*)"
+    - "Bash(python *linkedin_search.py*)"
+    - "Bash(python3 *linkedin_search.py*)"
+    - "Bash(python *getonbrd_search.py*)"
+    - "Bash(python3 *getonbrd_search.py*)"
   deny:
     []

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/drafter-reviewer.md

@@ -0,0 +1,39 @@
+# Drafter-Reviewer Rule (CVs y covers)
+
+Adaptado del workflow `/apply` de MadsLorentzen/ai-job-search. Todo CV custom o cover letter para una aplicación pasa por un reviewer de contexto fresco ANTES de exportarse a PDF. El que redacta no se auto-revisa.
+
+Las rutas son relativas al career workspace (`./career-workspace/` o env `CAREER_WORKSPACE`).
+
+## Cuándo aplica
+
+- Al terminar el borrador de un CV custom (flujo cv-tailor) o de una cover / mensaje de aplicación (flujo cover-letter) destinado a una postulación concreta.
+- NO aplica a ediciones menores de un CV ya revisado (typos, cambiar una fecha) ni a los CVs base de `02-CVs/` fuera de una postulación.
+
+## El paso reviewer
+
+Lanzar UN agente `general-purpose` de contexto fresco vía el Agent tool, con este contenido inline en el prompt (para que no dependa de leer archivos de la conversación):
+
+1. El texto completo de la job description.
+2. El borrador del CV y/o cover, verbatim.
+3. Instrucción de lectura acotada: solo puede leer `01-Perfiles/<perfil usado>.md` del workspace. NO debe leer los templates ni el resto del workspace - critica contenido, no estructura.
+4. Instrucción de research: búsqueda web breve sobre la empresa (misión, producto, noticias recientes, cultura) para detectar ángulos no aprovechados.
+
+El reviewer devuelve dos partes:
+
+- **Parte A - reemplazos mecánicos:** lista JSON de objetos `{ "old_string": "<texto exacto del borrador>", "new_string": "<reemplazo>", "motivo": "<una línea>" }`. El `old_string` debe ser cita textual para aplicarse con Edit sin ambigüedad.
+- **Parte B - sugerencias narrativas**, agrupadas por categoría:
+  - Keywords ATS de la JD que faltan o aparecen solo como sinónimo
+  - Ángulos de empresa no aprovechados (del research)
+  - Bullets que se pueden reformular como logro medible
+  - Tono / estilo (registro, longitud, muletillas)
+
+## Reglas de aplicación del feedback
+
+- **Una sola ronda.** El drafter aplica la Parte A, incorpora de la Parte B lo que corresponda, y sigue. Sin ida y vuelta iterativo.
+- **Never stuff keywords:** si una keyword de la JD es un gap real del candidato, NO se agrega al CV; se reconoce honestamente en el cover si vale la pena.
+- Nada de guiones largos en el resultado final: si el reviewer sugiere texto con em-dash o en-dash, se normaliza a `-` al aplicarlo.
+- Recién después de aplicar el feedback se exporta: `python .claude/skills/cv-ats-export/scripts/cv_export.py "<CV>"` (o la copia instalada en `<workspace>/tools/`; incluye verificación ATS automática de la capa de texto).
+
+## Registro
+
+En la nota de aplicación (`03-Aplicaciones/`), dejar en `## Notas` un resumen de 3-5 decisiones de tailoring (qué se enfatizó, qué ángulo de empresa se usó, qué gap se reconoció). Sirve para calibrar futuras aplicaciones y para el prep de entrevista.

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/cold-outreach/SKILL.md

@@ -1,15 +1,15 @@
 ---
 name: cold-outreach
-description: "Write cold LinkedIn/email messages from a job-seeker to recruiters, hiring managers and referrals — plus post-application follow-up sequences that get replies. For B2B sales outreach use cold-email instead. Triggers: mensaje en frio recruiter, escribirle a un reclutador, follow up postulacion, networking message, pedir referido, contactar hiring manager."
+description: "Write cold LinkedIn/email messages from a job-seeker to recruiters, hiring managers and referrals - plus post-application follow-up sequences that get replies. For B2B sales outreach use cold-email instead. Triggers: mensaje en frio recruiter, escribirle a un reclutador, follow up postulacion, networking message, pedir referido, contactar hiring manager."
 argument-hint: "[contact-note | recruiter + company]"
 category: "career"
 user-invocable: true
 allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch
 ---
 
-# Cold Outreach — Job-seeker → Recruiter / Hiring Manager
+# Cold Outreach - Job-seeker → Recruiter / Hiring Manager
 
-Escribís mensajes en frío de un **candidato** a recruiters, hiring managers y referidos, y secuencias de **follow-up** post-aplicación que reciben respuesta. Esto NO es venta B2B (para eso está `/cold-email`) — el ángulo es conseguir una conversación o un referido, sin sonar a spam ni a desesperación.
+Escribís mensajes en frío de un **candidato** a recruiters, hiring managers y referidos, y secuencias de **follow-up** post-aplicación que reciben respuesta. Esto NO es venta B2B (para eso está `/cold-email`) - el ángulo es conseguir una conversación o un referido, sin sonar a spam ni a desesperación.
 
 ## Cuándo usar cada variante
 
@@ -24,7 +24,7 @@ Escribís mensajes en frío de un **candidato** a recruiters, hiring managers y
 ## Principios
 
 - **Personalizá la primera línea.** Algo real de esa persona/empresa/rol. Si sirve para 100 personas, no sirve para ninguna.
-- **Corto.** LinkedIn: 50–125 palabras. La connection note: <300 caracteres.
+- **Corto.** LinkedIn: 50-125 palabras. La connection note: <300 caracteres.
 - **Una pregunta / un CTA.** Bajá la fricción de responder.
 - **Vos resolvés algo para ellos**, no "estoy buscando trabajo, ¿me ayudás?". El foco es el valor que aportás al equipo.
 - **Sin paredes de texto, sin CV adjunto en el primer toque** (salvo que lo pidan).
@@ -33,26 +33,26 @@ Escribís mensajes en frío de un **candidato** a recruiters, hiring managers y
 ## Estructura de un primer mensaje
 
 1. **Gancho personal** (1 línea): por qué *a esta persona*.
-2. **Quién sos + fit** (1–2 líneas): rol + el logro más relevante para ellos.
+2. **Quién sos + fit** (1-2 líneas): rol + el logro más relevante para ellos.
 3. **CTA suave** (1 línea): ¿15 min para charlar? / ¿abierto a una intro? / dejé mi aplicación, encantado de dar contexto.
 
 ## Secuencia de follow-up post-aplicación
 
-- **Día 0** — aplicación enviada (+ mensaje al recruiter/hiring manager si tenés el contacto).
-- **Día 4–5** — follow-up 1: reafirmá interés + agregá *algo nuevo* (un proyecto relevante, una idea sobre su producto). No "¿novedades?".
-- **Día 10–12** — follow-up 2 (último): breve, profesional, dejá la puerta abierta. Si no hay respuesta, cerrás el loop con dignidad.
+- **Día 0** - aplicación enviada (+ mensaje al recruiter/hiring manager si tenés el contacto).
+- **Día 4-5** - follow-up 1: reafirmá interés + agregá *algo nuevo* (un proyecto relevante, una idea sobre su producto). No "¿novedades?".
+- **Día 10-12** - follow-up 2 (último): breve, profesional, dejá la puerta abierta. Si no hay respuesta, cerrás el loop con dignidad.
 
 Cada follow-up debe tener un **gancho propio** y leerse solo, sin depender de los anteriores.
 
 ## Proceso
 
 1. Leer la nota de `05-Contactos/` (o crearla) y la de `04-Empresas/`.
-2. Investigar a la persona (rol, equipo, algo reciente) — WebFetch del perfil público si hay URL.
+2. Investigar a la persona (rol, equipo, algo reciente) - WebFetch del perfil público si hay URL.
 3. Elegir variante + canal.
 4. Draftear mensaje + 1 variante de apertura.
 5. Registrar en `05-Contactos/` (historial de interacciones) y planificar el follow-up.
 
-> Nota: Claude no accede a tu LinkedIn ni envía mensajes — redacta para que vos copies/pegues y registres la interacción.
+> Nota: Claude no accede a tu LinkedIn ni envía mensajes - redacta para que vos copies/pegues y registres la interacción.
 
 ## Idioma