claude-code-arcane 1.4.0 → 2.0.0

package/CHANGELOG.md

@@ -1,3 +1,41 @@
+# [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.**
+> **337 skills, 87 agents, 15 hooks and 20 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,7 +192,7 @@ 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 |
 | `+self-improving` | Agent self-improvement and skill extraction | 2 | — |
 | `+statusline` | Claude Code status bar (branch, division, session info) | 0 | — |
@@ -352,7 +352,7 @@ claude-code-arcane/
 ├── profiles/                  # 29 profiles (YAML)
 ├── agents/                    # 13 dirs, 86+ agents (Markdown)
 ├── hooks/                     # 15 lifecycle hooks (Bash)
-├── rules/                     # 19 rules (Markdown)
+├── rules/                     # 20 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,6 @@
 # Skills Catalog — Claude Code Arcane
 
-Catalogo completo de los 333 skills disponibles para proyectos consumidores. Organizados por division.
+Catalogo completo de los 337 skills disponibles para proyectos consumidores. Organizados por division.
 
 ## Como ejecutar un skill
 
@@ -432,7 +432,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 +443,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]` |

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 **337 skills**, **87 agents**, **15 hooks**, and **20 rules** that you selectively deploy into any project. Instead of shipping everything to every project (wasting tokens and degrading performance), you pick a **profile** that matches your stack and only the relevant tools get installed.
 
 ## Table of Contents
 

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.0.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/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/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
 

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)