claude-code-arcane 1.4.0 → 2.1.0

package/skills/cold-outreach/references/recruiter-playbook.md

@@ -1,10 +1,10 @@
 # Recruiter / Hiring Manager Playbook
 
-Plantillas y psicología para outreach de candidato. Adaptá siempre la primera línea — las plantillas son esqueleto, no copy-paste.
+Plantillas y psicología para outreach de candidato. Adaptá siempre la primera línea - las plantillas son esqueleto, no copy-paste.
 
 ## Por qué responden (y por qué no)
 
-Responden cuando: el mensaje es corto, claro sobre el fit, fácil de responder, y se nota que es para *ellos*. No responden cuando: es genérico, largo, pide demasiado de entrada, o suena desesperado. El recruiter recibe decenas por día — el filtro es "¿esto me ahorra trabajo o me lo agrega?".
+Responden cuando: el mensaje es corto, claro sobre el fit, fácil de responder, y se nota que es para *ellos*. No responden cuando: es genérico, largo, pide demasiado de entrada, o suena desesperado. El recruiter recibe decenas por día - el filtro es "¿esto me ahorra trabajo o me lo agrega?".
 
 ## Plantillas
 
@@ -37,14 +37,14 @@ Hola {nombre}, me interesa mucho {empresa/área}. Vengo de {1 cosa}.
 Me encantaría conectar y, si surge, charlar sobre {rol/equipo}.
 ```
 
-### 5. Follow-up 1 (día 4–5) — con valor nuevo
+### 5. Follow-up 1 (día 4-5) - con valor nuevo
 ```
 Hola {nombre}, te escribo para reafirmar mi interés en {rol}.
 Sumo un dato: {proyecto/idea relevante para su producto}.
 Quedo a disposición para lo que necesiten del proceso.
 ```
 
-### 6. Follow-up 2 (día 10–12) — cierre digno
+### 6. Follow-up 2 (día 10-12) - cierre digno
 ```
 Hola {nombre}, entiendo que están con mucho.
 Dejo la puerta abierta por si avanza {rol}; me encantaría sumar.
@@ -55,7 +55,7 @@ Dejo la puerta abierta por si avanza {rol}; me encantaría sumar.
 
 - Máximo 2 follow-ups. Después, soltar.
 - Cada follow-up agrega algo (no "¿novedades?").
-- Espaciar 4–5 días. Nunca el mismo día ni días consecutivos.
+- Espaciar 4-5 días. Nunca el mismo día ni días consecutivos.
 - Registrar cada toque en la nota de `05-Contactos/`.
 
 ## Tono

package/skills/cover-letter/SKILL.md

@@ -7,9 +7,9 @@ user-invocable: true
 allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch
 ---
 
-# Cover Letter — Mensaje de aplicación de élite
+# Cover Letter - Mensaje de aplicación de élite
 
-Escribís cover letters y mensajes de aplicación **concisos, seguros y custom** — que suenan a una persona que entendió el rol y la empresa, no a una plantilla. El objetivo: que el lector quiera leer el CV.
+Escribís cover letters y mensajes de aplicación **concisos, seguros y custom** - que suenan a una persona que entendió el rol y la empresa, no a una plantilla. El objetivo: que el lector quiera leer el CV.
 
 ## Inputs
 
@@ -20,19 +20,19 @@ Escribís cover letters y mensajes de aplicación **concisos, seguros y custom**
 
 ## Principios
 
-- **Una página máximo; idealmente 150–250 palabras** para mensajes, 250–350 para carta formal.
+- **Una página máximo; idealmente 150-250 palabras** para mensajes, 250-350 para carta formal.
 - **El primer renglón gana o pierde.** Nada de "I am writing to apply for…". Abrí con un gancho específico: un logro relevante, un punto de conexión con la empresa, o por qué este rol te mueve.
-- **Mostrá fit, no historia.** 1–2 logros que mapean directo a lo que piden, con número.
+- **Mostrá fit, no historia.** 1-2 logros que mapean directo a lo que piden, con número.
 - **Específico de la empresa.** Una frase que demuestre que investigaste (producto, valor, problema que resuelven). Si la podés pegar en otra aplicación, no sirve.
 - **Confiado, no arrogante; cálido, no servil.** Ni "would be honored", ni "I'm the best candidate".
 - **CTA simple al final.** Disponibilidad / ganas de charlar, sin rogar.
 
 ## Estructura (carta formal)
 
-1. **Hook** — gancho específico (logro o conexión real).
-2. **Fit** — 1–2 logros mapeados a must-haves del JD, con métrica.
-3. **Empresa** — por qué *esta* empresa/rol (research real).
-4. **Cierre** — CTA breve + gracias.
+1. **Hook** - gancho específico (logro o conexión real).
+2. **Fit** - 1-2 logros mapeados a must-haves del JD, con métrica.
+3. **Empresa** - por qué *esta* empresa/rol (research real).
+4. **Cierre** - CTA breve + gracias.
 
 ## Estructura (mensaje corto / LinkedIn / email)
 

package/skills/cv-ats-export/SKILL.md

@@ -1,22 +1,23 @@
 ---
 name: cv-ats-export
-description: "Export a Markdown CV to an ATS-compliant PDF (single column, selectable text, A4) using headless Chrome/Edge — no Obsidian or design tool needed. Triggers: exportar CV a PDF, generar PDF del CV, CV ATS PDF, convertir CV markdown a PDF, imprimir CV."
+description: "Export a Markdown CV to an ATS-compliant PDF (single column, selectable text, A4) using headless Chrome/Edge - no Obsidian or design tool needed. Triggers: exportar CV a PDF, generar PDF del CV, CV ATS PDF, convertir CV markdown a PDF, imprimir CV."
 argument-hint: "[cv-name | all] [--workspace <path>]"
 category: "career"
 user-invocable: true
 allowed-tools: Read, Glob, Grep, Bash, Write
 ---
 
-# CV ATS Export — Markdown → PDF ATS-compliant
+# CV ATS Export - Markdown → PDF ATS-compliant
 
-Convertís un CV en Markdown a un **PDF que pasa filtros ATS**: una sola columna, texto seleccionable (no imagen), A4, tipografía limpia. Usa Chrome o Edge en modo headless — no requiere Obsidian, LaTeX ni herramienta de diseño.
+Convertís un CV en Markdown a un **PDF que pasa filtros ATS**: una sola columna, texto seleccionable (no imagen), A4, tipografía limpia. Usa Chrome o Edge en modo headless - no requiere Obsidian, LaTeX ni herramienta de diseño.
 
-El motor es `scripts/cv_export.py`. La primera vez, instalalo en el workspace (`tools/cv_export.py`) para que quede versionado con los CVs; o corrélo directo desde el skill.
+El motor es `scripts/cv_export.py` + `scripts/verify_pdf.py` (verificación ATS post-export). La primera vez, instalá ambos en el workspace (`tools/`) para que queden versionados con los CVs; o corrélos directo desde el skill (van juntos: `cv_export` importa `verify_pdf` desde su mismo directorio).
 
 ## Requisitos
 
 - **Python 3** en el PATH.
 - **Google Chrome o Microsoft Edge** instalado (el script autodetecta rutas estándar en Windows/macOS/Linux).
+- **`pypdf` (opcional)** para la verificación ATS automática: `pip install pypdf`. Sin pypdf el export funciona igual y reporta `[ATS SKIP]`.
 - CVs en Markdown dentro de `02-CVs/` del career workspace, con headers (`# Nombre`, `## Sección`), bullets y `---` como separadores.
 
 ## Uso
@@ -30,6 +31,9 @@ python scripts/cv_export.py "CV - Acme - Backend"
 
 # Workspace explícito
 python scripts/cv_export.py --workspace ./career-workspace "CV - Acme - Backend"
+
+# Saltar la verificación ATS
+python scripts/cv_export.py --no-verify "CV - Acme - Backend"
 ```
 
 El script:
@@ -37,6 +41,15 @@ El script:
 2. Lee el `.md`, separa frontmatter, convierte el cuerpo a HTML con el CSS ATS embebido.
 3. Imprime a PDF con Chrome/Edge headless (`--headless=new --print-to-pdf`).
 4. Guarda en `02-CVs/exports/`. El nombre sale del frontmatter `archivo_pdf` si existe; si no, del nombre del `.md` (sin el prefijo `CV - `).
+5. **Verifica la capa de texto ATS** con `verify_pdf.py` (pypdf): texto extraíble (mínimo 200 chars), que el nombre del H1 y el email sobrevivan al export, y avisa si supera las 2 páginas. Reporta `[ATS OK]` / `[ATS WARN]` / `[ATS SKIP]`; nunca rompe el export. Se salta con `--no-verify`.
+
+Los dos `[ATS SKIP]` son distintos: `verify_pdf.py not found next to cv_export.py` significa que copiaste solo un archivo al workspace (instalar pypdf no cambia nada); `pypdf not installed` es el que se resuelve con `pip install pypdf`.
+
+`verify_pdf.py` también funciona standalone para chequear cualquier PDF:
+
+```bash
+python scripts/verify_pdf.py "02-CVs/exports/Backend.pdf" --min-chars 200 --max-pages 2 --contains "Jane Doe"
+```
 
 ## Markdown soportado
 
@@ -51,12 +64,12 @@ El script:
 
 ## Personalizar el estilo
 
-El CSS ATS está en la constante `CSS` dentro de `scripts/cv_export.py` (tamaño de fuente, márgenes A4, estilos de h1/h2). Editá ahí si querés ajustar tipografía o espaciado — mantené una sola columna y texto real.
+El CSS ATS está en la constante `CSS` dentro de `scripts/cv_export.py` (tamaño de fuente, márgenes A4, estilos de h1/h2). Editá ahí si querés ajustar tipografía o espaciado - mantené una sola columna y texto real.
 
 ## Reglas
 
 - No metas tablas, columnas ni imágenes en el CV: rompen el parseo ATS.
-- Verificá el PDF generado: que el texto sea seleccionable y entre en 1–2 páginas.
+- Atendé los `[ATS WARN]`: un PDF-imagen o sin el nombre/email extraíbles no pasa filtros ATS. Usá `--no-verify` solo para iterar rápido sobre el layout.
 - No commitees PDFs con datos sensibles a un remoto sin confirmación.
 
 ## Handoff

package/skills/cv-ats-export/scripts/cv_export.py

@@ -8,6 +8,12 @@ Usage (from anywhere; the script locates the career workspace):
     python cv_export.py                          # all base CVs (CV - *.md)
     python cv_export.py "CV - Acme - Backend"    # a single CV (with/without .md)
     python cv_export.py --workspace ./career-workspace "CV - Acme"
+    python cv_export.py --no-verify ...          # skip the ATS verification
+
+After exporting, the PDF text layer is verified with verify_pdf.py (pypdf):
+extractable text, the H1 name and the email must survive the export, and a
+warning is printed above 2 pages. Reports [ATS OK] / [ATS WARN]; if pypdf is
+not installed, [ATS SKIP] without breaking the export.
 
 Workspace resolution order:
     1. --workspace <path> flag
@@ -204,7 +210,41 @@ def find_browser():
     return None
 
 
-def export(md_path, browser, cv_dir, export_dir):
+def verify_ats(pdf_path, body):
+    """Verify the exported PDF's text layer. Never breaks the export: reports."""
+    # Two distinct failures, two distinct messages: verify_pdf.py missing next to
+    # this script (installing pypdf would not help) vs pypdf missing, which
+    # verify_pdf only imports when it actually reads the PDF.
+    try:
+        from verify_pdf import verify
+    except ImportError:
+        print(f"        [ATS SKIP] verify_pdf.py not found next to {Path(__file__).name}")
+        return
+
+    contains = []
+    m = re.search(r"^#\s+(.+)$", body, re.MULTILINE)
+    if m:
+        contains.append(re.sub(r"\*|\[|\]\([^)]*\)", "", m.group(1)).strip())
+    m = re.search(r"[\w.+-]+@[\w-]+\.[\w.]+", body)
+    if m:
+        contains.append(m.group(0))
+
+    try:
+        problems = verify(pdf_path, min_chars=200, contains=contains, max_pages=2)
+    except ImportError:
+        print("        [ATS SKIP] pypdf not installed (pip install pypdf)")
+        return
+    except Exception as e:
+        problems = [f"could not verify: {e}"]
+
+    if problems:
+        for p in problems:
+            print(f"        [ATS WARN] {p}")
+    else:
+        print("        [ATS OK] text layer verified (name + email extractable)")
+
+
+def export(md_path, browser, cv_dir, export_dir, check_ats=True):
     text = md_path.read_text(encoding="utf-8")
     fm, body = strip_frontmatter(text)
 
@@ -252,12 +292,15 @@ def export(md_path, browser, cv_dir, export_dir):
 
     size_kb = pdf_path.stat().st_size // 1024
     print(f"[OK] {md_path.name} -> {pdf_path} ({size_kb} KB)")
+    if check_ats:
+        verify_ats(pdf_path, body)
     return True
 
 
 def parse_args(argv):
     workspace = None
     names = []
+    check_ats = True
     i = 0
     while i < len(argv):
         a = argv[i]
@@ -266,14 +309,16 @@ def parse_args(argv):
             workspace = argv[i] if i < len(argv) else None
         elif a.startswith("--workspace="):
             workspace = a.split("=", 1)[1]
+        elif a == "--no-verify":
+            check_ats = False
         else:
             names.append(a)
         i += 1
-    return workspace, names
+    return workspace, names, check_ats
 
 
 def main():
-    workspace, names = parse_args(sys.argv[1:])
+    workspace, names, check_ats = parse_args(sys.argv[1:])
 
     browser = find_browser()
     if not browser:
@@ -298,7 +343,7 @@ def main():
         print(f"[ERROR] No CVs (CV - *.md) found in {cv_dir}.")
         sys.exit(1)
 
-    ok = all([export(t, browser, cv_dir, export_dir) for t in targets])
+    ok = all([export(t, browser, cv_dir, export_dir, check_ats) for t in targets])
     sys.exit(0 if ok else 1)
 
 

package/skills/cv-ats-export/scripts/verify_pdf.py

@@ -0,0 +1,90 @@
+"""
+verify_pdf.py — Verify that an exported PDF is ATS-compliant.
+
+Checks that the PDF has an extractable text layer (not an image), the
+expected page count, and that given strings (name, email) survived the
+export. Adapted from tools/verify_pdf.py of MadsLorentzen/ai-job-search,
+replacing poppler (pdftotext/pdfinfo) with pypdf so it runs on Windows
+without external binaries.
+
+Usage:
+    python verify_pdf.py <pdf> [--pages N] [--max-pages N] [--min-chars N]
+                               [--contains TEXT ...]
+
+Example:
+    python verify_pdf.py "career-workspace/02-CVs/exports/Backend.pdf" \
+        --min-chars 200 --contains "Jane Doe"
+
+Exit code 0 if all checks pass, 1 if any check fails, 2 if pypdf is missing.
+"""
+
+import argparse
+import sys
+from pathlib import Path
+
+
+def extract_text(pdf_path):
+    """Return (page_count, normalized_text) of the PDF."""
+    from pypdf import PdfReader
+
+    reader = PdfReader(str(pdf_path))
+    text = "\n".join(page.extract_text() or "" for page in reader.pages)
+    return len(reader.pages), " ".join(text.split())
+
+
+def verify(pdf_path, pages=None, min_chars=1, contains=(), max_pages=None):
+    """Return a list of problems (empty = PDF OK). Raises ImportError without pypdf."""
+    pdf_path = Path(pdf_path)
+    if not pdf_path.exists():
+        return [f"does not exist: {pdf_path}"]
+
+    n_pages, text = extract_text(pdf_path)
+    problems = []
+
+    if pages is not None and n_pages != pages:
+        problems.append(f"has {n_pages} pages (expected {pages})")
+    if max_pages is not None and n_pages > max_pages:
+        problems.append(f"has {n_pages} pages (ideally 1-{max_pages} for a CV)")
+    if len(text) < min_chars:
+        problems.append(
+            f"text layer has {len(text)} extractable chars (minimum {min_chars}); "
+            "likely an image-only PDF that an ATS cannot read"
+        )
+    for needle in contains:
+        if " ".join(needle.split()).lower() not in text.lower():
+            problems.append(f'missing required text: "{needle}"')
+
+    return problems
+
+
+def main():
+    ap = argparse.ArgumentParser(description="Verify the ATS text layer of a PDF.")
+    ap.add_argument("pdf", help="path to the PDF")
+    ap.add_argument("--pages", type=int, default=None, help="expected page count")
+    ap.add_argument("--min-chars", type=int, default=1, help="minimum extractable chars")
+    ap.add_argument("--max-pages", type=int, default=None, help="warn above N pages")
+    ap.add_argument(
+        "--contains", action="append", default=[], metavar="TEXT",
+        help="string that must appear in the text (repeatable)",
+    )
+    args = ap.parse_args()
+
+    try:
+        problems = verify(
+            args.pdf, args.pages, args.min_chars, args.contains, args.max_pages
+        )
+    except ImportError:
+        print("[ERROR] pypdf is missing. Install with: pip install pypdf")
+        sys.exit(2)
+
+    name = Path(args.pdf).name
+    if problems:
+        for p in problems:
+            print(f"[FAIL] {name}: {p}")
+        sys.exit(1)
+    print(f"[OK] {name}: ATS text layer verified")
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

package/skills/cv-tailor/SKILL.md

@@ -7,9 +7,9 @@ user-invocable: true
 allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch
 ---
 
-# CV Tailor — Adaptar el CV a la oferta
+# CV Tailor - Adaptar el CV a la oferta
 
-Tomás un job description y el perfil base del usuario, y producís un **CV custom** que matchea con los filtros automáticos (ATS) y con la lectura humana del hiring manager. No reescribís la verdad — la reorganizás y la traducís al vocabulario de la oferta.
+Tomás un job description y el perfil base del usuario, y producís un **CV custom** que matchea con los filtros automáticos (ATS) y con la lectura humana del hiring manager. No reescribís la verdad - la reorganizás y la traducís al vocabulario de la oferta.
 
 ## Inputs
 
@@ -20,7 +20,7 @@ Tomás un job description y el perfil base del usuario, y producís un **CV cust
 ## Proceso
 
 ### 1. Analizar la oferta
-- Extraer **keywords literales** del JD: tecnologías, metodologías, responsabilidades, soft skills, seniority. Literal importa — el ATS hace matching de strings (ej: si piden "React.js" no asumas que "React" matchea igual).
+- Extraer **keywords literales** del JD: tecnologías, metodologías, responsabilidades, soft skills, seniority. Literal importa - el ATS hace matching de strings (ej: si piden "React.js" no asumas que "React" matchea igual).
 - Detectar **must-have vs nice-to-have**.
 - Detectar **señales de cultura / ángulo** (startup vs enterprise, code-forward, ownership, etc.).
 - Ver `references/ats-keywords.md` para cómo extraer y mapear keywords.
@@ -38,17 +38,17 @@ Tomás un job description y el perfil base del usuario, y producís un **CV cust
 ### 4. Score before/after
 - Calcular un **match rate** aproximado: % de keywords/requisitos del JD presentes en el CV, **antes** vs **después** del tailoring.
 - Reportar el delta ("match 48% → 81%") y qué keywords se cubrieron.
-- **Flag de keyword stuffing:** marcar cualquier inserción que a un revisor humano le suene forzada o poco natural — el objetivo es pasar el ATS *y* leer bien para una persona.
+- **Flag de keyword stuffing:** marcar cualquier inserción que a un revisor humano le suene forzada o poco natural - el objetivo es pasar el ATS *y* leer bien para una persona.
 
 ### 5. Producir el CV custom
 - Crear/actualizar la nota en `02-CVs/CV - <Empresa> - <Rol>.md` usando el template `CV Custom` (`Templates/CV Custom.md`).
 - Completar frontmatter (`perfil_base`, `aplicacion`, `empresa`, `archivo_pdf`).
-- Documentar las decisiones (keywords, qué se resaltó/bajó) en las secciones del template — sirve para la entrevista y para iterar.
+- Documentar las decisiones (keywords, qué se resaltó/bajó) en las secciones del template - sirve para la entrevista y para iterar.
 - El cuerpo del CV en sí debe quedar listo para `/cv-ats-export` (markdown limpio: `# nombre`, `## secciones`, bullets, `---`).
 
 ## Formato del CV (ATS-friendly)
 
-- **Una columna.** Sin tablas, sin cajas de texto, sin columnas — los ATS las leen mal.
+- **Una columna.** Sin tablas, sin cajas de texto, sin columnas - los ATS las leen mal.
 - Secciones estándar con headers claros: Summary, Experience, Skills, Projects, Education.
 - Fechas consistentes (MM/YYYY).
 - Sin gráficos ni imágenes para el contenido crítico.
@@ -62,7 +62,7 @@ CV en **inglés** para roles internacionales/remotos globales; **español** si l
 
 - Nunca inventar experiencia, fechas o métricas. Tailoring = reorganizar y traducir, no mentir.
 - No keyword-stuffing: cada keyword debe vivir en un bullet verdadero.
-- Un CV custom por postulación — no pisar el perfil base ni el maestro.
+- Un CV custom por postulación - no pisar el perfil base ni el maestro.
 - Después de generar el `.md`, recordar al usuario correr `/cv-ats-export` para el PDF.
 
 ## Handoff

package/skills/cv-tailor/references/ats-keywords.md

@@ -1,4 +1,4 @@
-# ATS Keywords — Cómo extraer y mapear
+# ATS Keywords - Cómo extraer y mapear
 
 Los Applicant Tracking Systems (Greenhouse, Lever, Workday, Workable, etc.) hacen un primer filtro automático antes de que un humano vea el CV. Entender cómo "leen" cambia el resultado.
 
@@ -11,12 +11,12 @@ Los Applicant Tracking Systems (Greenhouse, Lever, Workday, Workable, etc.) hace
 
 ## Extracción de keywords del JD
 
-1. **Hard skills / tecnologías** — lenguajes, frameworks, DBs, cloud, herramientas. Copiá la forma **literal** (React.js ≠ React ≠ ReactJS para un match exacto; cuando puedas, incluí la variante que usa la oferta).
-2. **Responsabilidades / verbos** — "design REST APIs", "lead a team", "CI/CD pipelines".
-3. **Metodologías** — Agile, Scrum, TDD, clean architecture.
-4. **Seniority y años** — "5+ years", "senior", "lead".
-5. **Soft skills explícitos** — communication, ownership, cross-functional.
-6. **Señales de cultura / frases gatillo** — ej. "code-forward", "startup mentality", "high autonomy". Suelen indicar qué valoran y dan ángulo para el summary y la cover letter.
+1. **Hard skills / tecnologías** - lenguajes, frameworks, DBs, cloud, herramientas. Copiá la forma **literal** (React.js ≠ React ≠ ReactJS para un match exacto; cuando puedas, incluí la variante que usa la oferta).
+2. **Responsabilidades / verbos** - "design REST APIs", "lead a team", "CI/CD pipelines".
+3. **Metodologías** - Agile, Scrum, TDD, clean architecture.
+4. **Seniority y años** - "5+ years", "senior", "lead".
+5. **Soft skills explícitos** - communication, ownership, cross-functional.
+6. **Señales de cultura / frases gatillo** - ej. "code-forward", "startup mentality", "high autonomy". Suelen indicar qué valoran y dan ángulo para el summary y la cover letter.
 
 ## Mapeo contra el perfil
 
@@ -24,7 +24,7 @@ Los Applicant Tracking Systems (Greenhouse, Lever, Workday, Workable, etc.) hace
 |---|---|---|---|
 | React.js | Sí | "Built React + TS frontends @ X" | resaltar arriba |
 | Kubernetes | Parcial | exposición en CI/CD | mencionar honesto |
-| Go | No | — | gap; no inventar |
+| Go | No | - | gap; no inventar |
 
 - **Must-have que tenés** → arriba, con espacio, con la palabra exacta.
 - **Must-have parcial** → mencionar con honestidad ("exposure to…").
@@ -41,6 +41,6 @@ Los Applicant Tracking Systems (Greenhouse, Lever, Workday, Workable, etc.) hace
 - [ ] Una sola columna, sin tablas/text boxes.
 - [ ] Headers de sección estándar (Experience, Skills, Education…).
 - [ ] Fechas consistentes MM/YYYY.
-- [ ] Texto seleccionable (no imagen) — el export de `/cv-ats-export` ya lo garantiza.
+- [ ] Texto seleccionable (no imagen) - el export de `/cv-ats-export` ya lo garantiza.
 - [ ] Nombre del archivo profesional (`Nombre_Apellido_Empresa.pdf`).
 - [ ] Contacto en el cuerpo, no en el header/footer del documento.

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/interview-prep/SKILL.md

@@ -7,14 +7,14 @@ user-invocable: true
 allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch
 ---
 
-# Interview Prep — Preparación de entrevista
+# Interview Prep - Preparación de entrevista
 
 Preparás al usuario para una entrevista concreta: research de la empresa, banco de preguntas probable según rol y ronda, respuestas **STAR** construidas desde su experiencia real, preguntas inteligentes para hacer, y red flags a detectar. El output queda en una nota de `06-Entrevistas/`.
 
 ## Inputs
 
 - **Aplicación / empresa / rol** (`03-Aplicaciones/`, `04-Empresas/`) y la **ronda** (recruiter screen, técnica, system design, hiring manager, cultural, final).
-- **Perfil maestro** (`01-Perfiles/`) — de ahí salen las historias para las respuestas STAR.
+- **Perfil maestro** (`01-Perfiles/`) - de ahí salen las historias para las respuestas STAR.
 - **Entrevistadores** si se conocen (research de background ayuda).
 
 ## Qué producís
@@ -28,19 +28,19 @@ Preparás al usuario para una entrevista concreta: research de la empresa, banco
 
 ### 2. Banco de preguntas por ronda
 - **Recruiter screen:** motivación, expectativas salariales, disponibilidad, "contame de vos".
-- **Técnica:** según stack del JD — fundamentos, problemas, debugging, code review.
+- **Técnica:** según stack del JD - fundamentos, problemas, debugging, code review.
 - **System design** (si aplica): patrones, trade-offs, escala.
 - **Hiring manager / comportamiento:** liderazgo, conflicto, fracaso, impacto.
 - **Cultural:** valores, formas de trabajo, por qué esta empresa.
-- Marcar las **3–5 más probables** para este rol específico.
+- Marcar las **3-5 más probables** para este rol específico.
 
 ### 3. Respuestas STAR
 - Construir respuestas con el método **STAR** (Situación, Tarea, Acción, Resultado) usando logros reales del perfil maestro.
-- Cada respuesta: concreta, con métrica, 60–90 segundos hablada.
+- Cada respuesta: concreta, con métrica, 60-90 segundos hablada.
 - Ver `references/star-framework.md`.
 
 ### 4. Preguntas para hacer
-- 5–7 preguntas inteligentes que demuestran research y filtran si la empresa te conviene (equipo, expectativas de los primeros 90 días, cómo miden éxito, deuda técnica, proceso).
+- 5-7 preguntas inteligentes que demuestran research y filtran si la empresa te conviene (equipo, expectativas de los primeros 90 días, cómo miden éxito, deuda técnica, proceso).
 
 ### 5. Red flags a detectar
 - Señales de mala empresa/equipo durante la entrevista (proceso caótico, evasión sobre cultura/turnover, expectativas irreales, falta de claridad de rol, hostilidad).
@@ -56,7 +56,7 @@ Preparás al usuario para una entrevista concreta: research de la empresa, banco
 
 1. Leer aplicación + empresa + perfil. WebFetch del sitio/notas de la empresa.
 2. Crear nota en `06-Entrevistas/` con el template `Entrevista`.
-3. Llenar research, banco de preguntas (marcando las top), STAR de las 3–5 historias clave, preguntas a hacer, red flags.
+3. Llenar research, banco de preguntas (marcando las top), STAR de las 3-5 historias clave, preguntas a hacer, red flags.
 4. Ofrecer un **mock**: vos hacés de entrevistador y das feedback sobre las respuestas.
 5. Post-entrevista: ayudar a registrar feedback y definir próximo paso / follow-up (con `/cold-outreach`).
 

package/skills/interview-prep/references/star-framework.md

@@ -1,15 +1,15 @@
-# STAR Framework — Respuestas de comportamiento
+# STAR Framework - Respuestas de comportamiento
 
 STAR estructura respuestas a preguntas de comportamiento ("contame de una vez que…") para que sean concretas, completas y memorables. La mayoría de los candidatos divaga; STAR te da una historia con resultado.
 
 ## Las 4 partes
 
-- **S — Situación:** el contexto, breve. Dónde, cuándo, qué estaba pasando. (1–2 oraciones)
-- **T — Tarea:** tu responsabilidad / el problema a resolver. (1 oración)
-- **A — Acción:** qué hiciste *vos* (no "el equipo"). El grueso de la respuesta. Decisiones concretas. (2–4 oraciones)
-- **R — Resultado:** el impacto, **con número** siempre que se pueda. Qué aprendiste. (1–2 oraciones)
+- **S - Situación:** el contexto, breve. Dónde, cuándo, qué estaba pasando. (1-2 oraciones)
+- **T - Tarea:** tu responsabilidad / el problema a resolver. (1 oración)
+- **A - Acción:** qué hiciste *vos* (no "el equipo"). El grueso de la respuesta. Decisiones concretas. (2-4 oraciones)
+- **R - Resultado:** el impacto, **con número** siempre que se pueda. Qué aprendiste. (1-2 oraciones)
 
-Objetivo: 60–90 segundos hablado. Ni telegrama, ni monólogo de 5 minutos.
+Objetivo: 60-90 segundos hablado. Ni telegrama, ni monólogo de 5 minutos.
 
 ## Ejemplo
 
@@ -20,9 +20,9 @@ Objetivo: 60–90 segundos hablado. Ni telegrama, ni monólogo de 5 minutos.
 > **A:** Perfilé el hot path, encontré queries N+1 y serialización redundante; introduje caching por sesión y batch de writes, y agregué métricas para validar.
 > **R:** Latencia -25% y estabilidad del server +40%; duplicamos jugadores concurrentes sin sumar costos. Aprendí a medir antes de optimizar.
 
-## Banco de historias (preparar 5–6)
+## Banco de historias (preparar 5-6)
 
-Construí 5–6 historias STAR reutilizables desde el perfil maestro, cubriendo:
+Construí 5-6 historias STAR reutilizables desde el perfil maestro, cubriendo:
 
 1. **Logro/impacto** del que estés orgulloso (con métrica).
 2. **Problema técnico difícil** que resolviste.
@@ -31,11 +31,11 @@ Construí 5–6 historias STAR reutilizables desde el perfil maestro, cubriendo:
 5. **Liderazgo / iniciativa** (lideraste algo, mentoreaste, empujaste un cambio).
 6. **Ambigüedad / cambio de prioridades** que manejaste.
 
-La misma historia puede servir para varias preguntas — lo que cambia es qué parte enfatizás.
+La misma historia puede servir para varias preguntas - lo que cambia es qué parte enfatizás.
 
 ## Errores comunes
 
-- Quedarse en "nosotros" — la entrevista evalúa *tu* aporte. Decí "yo".
+- Quedarse en "nosotros" - la entrevista evalúa *tu* aporte. Decí "yo".
 - Saltearse el Resultado, o un resultado sin número.
 - Demasiada Situación, poca Acción.
 - Historias vagas/inventadas que no aguantan repreguntas.