claude-code-arcane 1.1.1 → 1.3.0

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

@@ -0,0 +1,65 @@
+# 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.
+
+## 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?".
+
+## Plantillas
+
+### 1. Recruiter que posteó un rol
+```
+Hola {nombre}, vi que están buscando {rol} en {empresa}.
+Soy {rol/seniority} con {logro relevante en 1 línea, con número}.
+Me interesa especialmente {algo real del rol/empresa}.
+¿Te sirve si te paso mi CV o coordinamos 15 min?
+```
+
+### 2. Hiring manager / futuro lead (mensaje de valor)
+```
+Hola {nombre}, sigo {producto/equipo de la empresa} y me llamó {detalle específico}.
+Vengo de {contexto}: {logro mapeado a lo que su equipo necesita}.
+Apliqué a {rol}; si te viene bien, encantado de darte contexto en una charla corta.
+```
+
+### 3. Pedir un referido (a alguien del equipo)
+```
+Hola {nombre}, vi que trabajás en {empresa} como {rol}.
+Estoy aplicando a {rol} ahí y me encantaría tu perspectiva sobre el equipo.
+Si te parece y te hace sentido, ¿estarías abierto a referirme? Sin problema si no.
+Te dejo mi perfil para que veas si encaja: {link}.
+```
+
+### 4. Connection note (<300 chars)
+```
+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
+```
+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
+```
+Hola {nombre}, entiendo que están con mucho.
+Dejo la puerta abierta por si avanza {rol}; me encantaría sumar.
+¡Gracias por el tiempo!
+```
+
+## Reglas de cadencia
+
+- 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.
+- Registrar cada toque en la nota de `05-Contactos/`.
+
+## Tono
+
+- Cálido y profesional, nunca servil ni agresivo.
+- Confiado: estás ofreciendo valor, no mendigando.
+- Humano: escribí como hablás, sin jerga corporativa vacía.

package/skills/cover-letter/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: cover-letter
+description: "Write concise, confident cover letters and application messages tailored to the company and the person who will read them. Triggers: cover letter, carta de presentacion, mensaje de aplicacion, application message, carta de motivacion, why I'm a fit."
+argument-hint: "[application-note | company + role]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch
+---
+
+# 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.
+
+## Inputs
+
+- **Rol y empresa** + el job description.
+- **Perfil base / maestro** (`01-Perfiles/`) para los logros y el ángulo.
+- **Research** de `04-Empresas/` y del contacto en `05-Contactos/` (a quién le escribís cambia el tono).
+- El **canal**: cover letter formal (campo del ATS), mensaje corto de LinkedIn/email, o párrafo de "why you" en un form.
+
+## Principios
+
+- **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.
+- **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.
+
+## Estructura (mensaje corto / LinkedIn / email)
+
+- Saludo personal (nombre del contacto si lo tenés).
+- 1 oración: quién sos + el logro más relevante.
+- 1 oración: por qué esta empresa/rol.
+- 1 oración: CTA (charlar / te dejo el CV).
+
+## Proceso
+
+1. Leer JD + research. Identificar los 2 must-haves donde más brillás.
+2. Elegir formato según canal.
+3. Draftear. Después **cortar sin piedad** todo lo genérico.
+4. Generar 2 variantes de apertura si el usuario quiere elegir.
+5. Guardar en la nota de aplicación (`03-Aplicaciones/`, sección cover letter) o en `07-Recursos/` si es reutilizable.
+
+## Idioma
+
+Inglés para roles internacionales; español si la empresa es hispanohablante. Espejá el idioma del JD ante la duda.
+
+## Anti-patrones (cortar siempre)
+
+- "I am writing to express my interest in…" / "Por medio de la presente…".
+- Recitar el CV en prosa.
+- Adjetivos vacíos sin evidencia (passionate, hardworking, team player).
+- Párrafos genéricos que sirven para cualquier empresa.
+- Pedir disculpas o sonar desesperado.
+
+## Handoff
+
+Pedí aprobación (approval) antes de guardar la carta en la nota de aplicación o en `07-Recursos/`. Cuando la cover letter está READY, el siguiente paso es `/cold-outreach` si hay un contacto al que escribirle directo.

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

@@ -0,0 +1,64 @@
+---
+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."
+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
+
+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.
+
+## Requisitos
+
+- **Python 3** en el PATH.
+- **Google Chrome o Microsoft Edge** instalado (el script autodetecta rutas estándar en Windows/macOS/Linux).
+- CVs en Markdown dentro de `02-CVs/` del career workspace, con headers (`# Nombre`, `## Sección`), bullets y `---` como separadores.
+
+## Uso
+
+```bash
+# Todos los CVs base (CV - *.md) del workspace
+python scripts/cv_export.py
+
+# Uno solo (con o sin .md)
+python scripts/cv_export.py "CV - Acme - Backend"
+
+# Workspace explícito
+python scripts/cv_export.py --workspace ./career-workspace "CV - Acme - Backend"
+```
+
+El script:
+1. Localiza el workspace (flag `--workspace`, env `CAREER_WORKSPACE`, o sube directorios buscando una carpeta `02-CVs`, o usa el cwd).
+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 - `).
+
+## Markdown soportado
+
+`# ## ### títulos` · `**negrita**` · `*itálica*` · `[texto](url)` · `- bullets` · `---` (regla horizontal). Un salto de línea simple dentro de un párrafo se renderiza como `<br>` (comportamiento tipo Obsidian).
+
+## Por qué este pipeline (y no Word/Canva)
+
+- **Texto seleccionable garantizado** → el ATS puede parsearlo (a diferencia de un PDF exportado como imagen).
+- **Una columna, sin tablas** → no se rompe el parseo.
+- **Reproducible y versionable** → el CV vive en Markdown (diffeable, en git), el PDF es un artefacto generado.
+- **Mismo estilo siempre** → el CSS ATS está embebido en 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.
+
+## 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.
+- No commitees PDFs con datos sensibles a un remoto sin confirmación.
+
+## Handoff
+
+Confirmá (approval) antes de instalar `cv_export.py` en el workspace o sobrescribir PDFs. Cuando el PDF está READY y verificado, el siguiente paso suele ser `/cover-letter` para el mensaje de aplicación.

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

@@ -0,0 +1,306 @@
+"""
+cv_export.py — Export Markdown CVs to ATS-compliant PDF.
+
+Converts a Markdown CV to styled HTML and prints it with headless Chrome/Edge
+(selectable text, single column, A4). No Obsidian, LaTeX or design tool needed.
+
+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"
+
+Workspace resolution order:
+    1. --workspace <path> flag
+    2. CAREER_WORKSPACE env var
+    3. walk up from the cwd looking for a folder containing "02-CVs" (or "02 - CVs")
+    4. the current working directory
+
+Output path:
+    - If frontmatter has `archivo_pdf`, the PDF is written to that path
+      relative to the CVs folder (<workspace>/02-CVs/<archivo_pdf>).
+    - Otherwise it goes to <workspace>/02-CVs/exports/<name>.pdf, where
+      <name> is the frontmatter field `archivo_final` if present, else the
+      .md filename with the "CV - " prefix stripped.
+
+Supported Markdown (what CVs use):
+  # ## ### headings · **bold** · *italic* · [text](url) · - bullets · ---
+  A single line break inside a paragraph becomes <br> (Obsidian-like).
+"""
+
+import html
+import os
+import re
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+# Possible names for the CVs folder (portable + Obsidian-style with spaces).
+CV_DIR_NAMES = ["02-CVs", "02 - CVs"]
+
+BROWSERS = [
+    # Windows
+    r"C:\Program Files\Google\Chrome\Application\chrome.exe",
+    r"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe",
+    r"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe",
+    r"C:\Program Files\Microsoft\Edge\Application\msedge.exe",
+    # macOS
+    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+    "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+    # Linux
+    "/usr/bin/google-chrome",
+    "/usr/bin/google-chrome-stable",
+    "/usr/bin/chromium",
+    "/usr/bin/chromium-browser",
+    "/usr/bin/microsoft-edge",
+]
+
+# ATS-friendly print style: single column, selectable text, A4.
+CSS = """
+@page { size: A4; margin: 18mm 16mm 18mm 16mm; }
+body {
+  font-family: "Calibri", "Arial", "Helvetica", sans-serif;
+  font-size: 10.5pt; line-height: 1.35; color: #000; background: #fff;
+  margin: 0; padding: 0;
+}
+h1 { font-size: 18pt; font-weight: 700; margin: 0 0 2pt 0; padding: 0; }
+h2 {
+  font-size: 12pt; font-weight: 700; text-transform: uppercase;
+  letter-spacing: 0.5pt; border-bottom: 0.5pt solid #000;
+  padding: 0 0 1pt 0; margin: 10pt 0 5pt 0;
+  page-break-after: avoid;
+}
+h3 { font-size: 11pt; font-weight: 700; margin: 6pt 0 2pt 0; padding: 0; page-break-after: avoid; }
+p  { margin: 2pt 0; page-break-inside: avoid; }
+ul, ol { margin: 2pt 0 4pt 0; padding-left: 16pt; }
+li { margin: 1pt 0; page-break-inside: avoid; }
+strong { font-weight: 700; }
+a { color: #000; text-decoration: none; }
+hr { border: none; border-top: 0.5pt solid #000; margin: 6pt 0; }
+"""
+
+
+def find_cv_dir(start):
+    """Walk up from `start` looking for a directory containing a CVs folder."""
+    cur = Path(start).resolve()
+    for base in [cur, *cur.parents]:
+        for name in CV_DIR_NAMES:
+            cand = base / name
+            if cand.is_dir():
+                return cand
+    return None
+
+
+def resolve_cv_dir(workspace_arg):
+    # 1. explicit --workspace
+    if workspace_arg:
+        ws = Path(workspace_arg).resolve()
+        for name in CV_DIR_NAMES:
+            if (ws / name).is_dir():
+                return ws / name
+        # maybe they passed the CVs dir directly
+        if ws.name in CV_DIR_NAMES and ws.is_dir():
+            return ws
+        print(f"[ERROR] No CVs folder ({' / '.join(CV_DIR_NAMES)}) under: {ws}")
+        sys.exit(1)
+    # 2. env var
+    env = os.environ.get("CAREER_WORKSPACE")
+    if env:
+        for name in CV_DIR_NAMES:
+            if (Path(env) / name).is_dir():
+                return Path(env).resolve() / name
+    # 3. walk up from cwd
+    found = find_cv_dir(Path.cwd())
+    if found:
+        return found
+    # 4. cwd fallback
+    print("[ERROR] Could not locate a CVs folder. Use --workspace <path>.")
+    sys.exit(1)
+
+
+def strip_frontmatter(text):
+    """Return (frontmatter_dict, body). Flat key: value frontmatter."""
+    fm = {}
+    if text.startswith("---"):
+        end = text.find("\n---", 3)
+        if end != -1:
+            for line in text[3:end].strip().splitlines():
+                if ":" in line:
+                    k, _, v = line.partition(":")
+                    fm[k.strip()] = v.strip().strip('"')
+            text = text[end + 4:]
+    return fm, text.lstrip("\n")
+
+
+def inline(s):
+    """Inline markdown -> HTML (escape first, then links/bold/italic)."""
+    s = html.escape(s, quote=False)
+    s = re.sub(r"\[([^\]]+)\]\(([^)]+)\)", r'<a href="\2">\1</a>', s)
+    s = re.sub(r"\*\*(.+?)\*\*", r"<strong>\1</strong>", s)
+    s = re.sub(r"(?<!\*)\*([^*\n]+)\*(?!\*)", r"<em>\1</em>", s)
+    return s
+
+
+def md_to_html(md):
+    out = []
+    paragraph = []
+    in_list = False
+
+    def flush_paragraph():
+        if paragraph:
+            out.append("<p>" + "<br>".join(inline(l) for l in paragraph) + "</p>")
+            paragraph.clear()
+
+    def close_list():
+        nonlocal in_list
+        if in_list:
+            out.append("</ul>")
+            in_list = False
+
+    for raw in md.splitlines():
+        line = raw.rstrip()
+        stripped = line.strip()
+
+        if not stripped:
+            flush_paragraph()
+            close_list()
+            continue
+
+        m = re.match(r"^(#{1,3})\s+(.*)", stripped)
+        if m:
+            flush_paragraph()
+            close_list()
+            level = len(m.group(1))
+            out.append(f"<h{level}>{inline(m.group(2))}</h{level}>")
+            continue
+
+        if re.match(r"^(-{3,}|\*{3,})$", stripped):
+            flush_paragraph()
+            close_list()
+            out.append("<hr>")
+            continue
+
+        m = re.match(r"^[-*]\s+(.*)", stripped)
+        if m:
+            flush_paragraph()
+            if not in_list:
+                out.append("<ul>")
+                in_list = True
+            out.append(f"<li>{inline(m.group(1))}</li>")
+            continue
+
+        close_list()
+        paragraph.append(stripped)
+
+    flush_paragraph()
+    close_list()
+    return "\n".join(out)
+
+
+def find_browser():
+    for path in BROWSERS:
+        if Path(path).exists():
+            return path
+    return None
+
+
+def export(md_path, browser, cv_dir, export_dir):
+    text = md_path.read_text(encoding="utf-8")
+    fm, body = strip_frontmatter(text)
+
+    if fm.get("archivo_pdf"):
+        pdf_path = cv_dir / fm["archivo_pdf"]
+    else:
+        name = fm.get("archivo_final") or md_path.stem.replace("CV - ", "")
+        pdf_path = export_dir / f"{name}.pdf"
+    pdf_path.parent.mkdir(parents=True, exist_ok=True)
+
+    doc = (
+        "<!DOCTYPE html><html><head><meta charset='utf-8'>"
+        f"<title>{html.escape(md_path.stem)}</title>"
+        f"<style>{CSS}</style></head><body>"
+        + md_to_html(body)
+        + "</body></html>"
+    )
+
+    with tempfile.NamedTemporaryFile(
+        "w", suffix=".html", delete=False, encoding="utf-8"
+    ) as tmp:
+        tmp.write(doc)
+        tmp_path = Path(tmp.name)
+
+    try:
+        result = subprocess.run(
+            [
+                browser,
+                "--headless=new",
+                "--disable-gpu",
+                "--no-pdf-header-footer",
+                f"--print-to-pdf={pdf_path}",
+                tmp_path.as_uri(),
+            ],
+            capture_output=True,
+            text=True,
+            timeout=120,
+        )
+        if result.returncode != 0 or not pdf_path.exists():
+            print(f"[ERROR] {md_path.name}: browser exit {result.returncode}")
+            print(result.stderr[-500:] if result.stderr else "(no stderr)")
+            return False
+    finally:
+        tmp_path.unlink(missing_ok=True)
+
+    size_kb = pdf_path.stat().st_size // 1024
+    print(f"[OK] {md_path.name} -> {pdf_path} ({size_kb} KB)")
+    return True
+
+
+def parse_args(argv):
+    workspace = None
+    names = []
+    i = 0
+    while i < len(argv):
+        a = argv[i]
+        if a == "--workspace":
+            i += 1
+            workspace = argv[i] if i < len(argv) else None
+        elif a.startswith("--workspace="):
+            workspace = a.split("=", 1)[1]
+        else:
+            names.append(a)
+        i += 1
+    return workspace, names
+
+
+def main():
+    workspace, names = parse_args(sys.argv[1:])
+
+    browser = find_browser()
+    if not browser:
+        print("[ERROR] Chrome/Edge not found in standard paths. Install one or edit BROWSERS.")
+        sys.exit(1)
+
+    cv_dir = resolve_cv_dir(workspace)
+    export_dir = cv_dir / "exports"
+
+    if names:
+        targets = []
+        for n in names:
+            p = cv_dir / (n if n.endswith(".md") else n + ".md")
+            if not p.exists():
+                print(f"[ERROR] Not found: {p}")
+                sys.exit(1)
+            targets.append(p)
+    else:
+        targets = sorted(cv_dir.glob("CV - *.md"))
+
+    if not targets:
+        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])
+    sys.exit(0 if ok else 1)
+
+
+if __name__ == "__main__":
+    main()

package/skills/cv-tailor/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: cv-tailor
+description: "Tailor a CV to a specific job description: extract ATS keywords, decide what to emphasize vs downplay, and rewrite achievement bullets in the offer's vocabulary, starting from a role profile. Triggers: adaptar CV, custom CV, tailor resume, CV para esta oferta, optimizar CV para ATS, matchear CV con job description."
+argument-hint: "[job-url | path-to-jd | application-note]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit, WebFetch
+---
+
+# 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.
+
+## Inputs
+
+- **El job description** (URL → usá WebFetch, o texto pegado, o una nota de `03-Aplicaciones/`).
+- **El perfil base**: `01-Perfiles/<Role>.md` (derivado del maestro vía `/master-profile derive`). Si no existe, sugerir crearlo.
+- **Research del contacto/empresa** si existe en `04-Empresas/` y `05-Contactos/`.
+
+## 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).
+- 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.
+
+### 2. Mapear contra el perfil
+- Por cada must-have: ¿qué experiencia/proyecto del perfil lo cubre? Marcar gaps honestos.
+- Decidir **qué resaltar** (lo que más alinea, arriba y con más espacio) y **qué bajar de volumen** (lo irrelevante para este rol).
+
+### 3. Reescribir
+- Reordenar experiencia y proyectos hacia el rol.
+- Reescribir bullets de logros usando el vocabulario de la oferta, manteniendo número→contexto→resultado.
+- Inyectar keywords de forma natural (en bullets reales, no en un "keyword stuffing" detectable).
+- Ajustar el headline/summary al rol exacto.
+
+### 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.
+
+### 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.
+- 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.
+- 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.
+- Verbos de acción + métricas.
+
+## Idioma
+
+CV en **inglés** para roles internacionales/remotos globales; **español** si la oferta/empresa es hispanohablante. Ante la duda, preguntar.
+
+## Reglas
+
+- 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.
+- Después de generar el `.md`, recordar al usuario correr `/cv-ats-export` para el PDF.
+
+## Handoff
+
+Pedí aprobación (approval) antes de escribir el CV custom. Cuando el `.md` está READY, el siguiente paso es `/cv-ats-export` para generar el PDF ATS y `/cover-letter` para el mensaje.

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

@@ -0,0 +1,46 @@
+# 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.
+
+## Cómo funciona un ATS (modelo mental)
+
+- Parsea el CV a texto plano y lo indexa.
+- Hace matching de **strings** y variantes contra la oferta y/o contra criterios del recruiter.
+- Rankea o filtra candidatos por densidad/relevancia de keywords y por campos estructurados (título, fechas, ubicación).
+- **Lo que rompe el parseo:** tablas, columnas, text boxes, headers/footers con datos, gráficos, iconos en lugar de texto, PDFs escaneados (imagen).
+
+## 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.
+
+## Mapeo contra el perfil
+
+| Keyword del JD | ¿Lo tengo? | Dónde lo demuestro (bullet/proyecto) | Acción |
+|---|---|---|---|
+| React.js | Sí | "Built React + TS frontends @ X" | resaltar arriba |
+| Kubernetes | Parcial | exposición en CI/CD | mencionar honesto |
+| 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…").
+- **Must-have que no tenés** → gap real; no lo inventes. Decidí si igual aplicás.
+
+## Inyección natural (no stuffing)
+
+- Cada keyword vive en un **bullet verdadero** con contexto y resultado.
+- Una sección "Skills" lista las tecnologías (bien para el ATS), pero las importantes también deben aparecer en la experiencia (bien para el humano y para el ranking).
+- Evitá listas de 40 tecnologías sin contexto: lee como relleno y diluye el ranking.
+
+## Checklist de formato ATS-safe
+
+- [ ] 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.
+- [ ] Nombre del archivo profesional (`Nombre_Apellido_Empresa.pdf`).
+- [ ] Contacto en el cuerpo, no en el header/footer del documento.