claude-code-arcane 1.3.0 → 2.0.0

package/skills/job-hunt/SKILL.md

@@ -7,9 +7,9 @@ user-invocable: true
 allowed-tools: Read, Glob, Grep, Bash, Write, Edit
 ---
 
-# Job Hunt — Career Workspace Orchestrator
+# Job Hunt - Career Workspace Orchestrator
 
-Eres el punto de entrada de la suite de búsqueda laboral. Tu trabajo es: detectar (o crear) el **career workspace**, entender en qué etapa está el usuario, y rutear al skill correcto. No hacés todo vos — orquestás.
+Eres el punto de entrada de la suite de búsqueda laboral. Tu trabajo es: detectar (o crear) el **career workspace**, entender en qué etapa está el usuario, y rutear al skill correcto. No hacés todo vos - orquestás.
 
 ## Idioma
 
@@ -32,26 +32,29 @@ career-workspace/
   07-Recursos/             cover letters reutilizables, links
   portfolio/               datos source-of-truth del portfolio web
   Templates/               plantillas con frontmatter
-  tools/                   cv_export.py (lo instala /cv-ats-export)
+  tools/                   cv_export.py + verify_pdf.py (los instala /cv-ats-export)
+                           y job_scraper/seen_jobs.json (memoria de dedup de /job-scrape)
 ```
 
 Es **portable y agnóstico de Obsidian**: usa `[[wikilinks]]` (funcionan en Obsidian si el usuario lo usa, y son legibles en texto plano), frontmatter YAML, y prefijos numéricos para ordenar carpetas. No requiere Obsidian instalado.
 
+Estados de una aplicación (frontmatter `estado`): `interesado → aplicado → entrevista → oferta`, con cierres `contratado | rechazado | sin_respuesta | declinada | descartado`. Los mueve `/job-outcome`; ninguna otra skill marca `aplicado`.
+
 ## Modos
 
-### `setup` — Crear el workspace
+### `setup` - Crear el workspace
 1. Preguntar dónde crear el workspace (default `./career-workspace/`) y el/los rol(es) objetivo.
 2. Crear el árbol de carpetas completo.
 3. Copiar los 7 templates desde `references/templates/` a `Templates/` del workspace.
 4. Crear `00-Dashboard.md` desde `references/templates/Dashboard.md`.
 5. Sugerir el siguiente paso: `/master-profile` para construir el perfil maestro.
 
-### `status` — Dónde estoy
+### `status` - Dónde estoy
 1. Leer `00-Dashboard.md` y escanear `03-Aplicaciones/`.
 2. Resumir: aplicaciones activas por prioridad, próximas entrevistas, ofertas que cierran pronto, gaps (aplicaciones sin CV/cover letter).
 3. Recomendar la acción de mayor impacto.
 
-### `next` — Qué hago ahora
+### `next` - Qué hago ahora
 Según el estado del workspace, recomendar el skill siguiente (ver routing).
 
 ## Routing
@@ -61,6 +64,10 @@ Según el estado del workspace, recomendar el skill siguiente (ver routing).
 | No hay workspace | `/job-hunt setup` |
 | Falta perfil maestro | `/master-profile` |
 | Encontrar/scorear ofertas, plan de búsqueda | `/job-search` |
+| Corrida de búsqueda con CLIs y dedup entre corridas | `/job-scrape` |
+| Postulación completa (nota + CV + cover + review + PDF) | `/job-aplicar` |
+| Registrar resultado/avance de una postulación | `/job-outcome` |
+| Gaps de skills agregados + plan de estudio | `/job-upskill` |
 | Adaptar CV a una oferta | `/cv-tailor` |
 | Exportar CV a PDF ATS | `/cv-ats-export` |
 | Escribir cover letter / mensaje de aplicación | `/cover-letter` |
@@ -71,17 +78,17 @@ Según el estado del workspace, recomendar el skill siguiente (ver routing).
 
 ## Workflow estándar para una nueva oportunidad
 
-1. `/job-search` → encontrar y scorear la oferta, crear nota en `03-Aplicaciones/` + `04-Empresas/`.
+1. `/job-scrape` → corrida de búsqueda con dedup (o `/job-search` para una oferta/búsqueda puntual): nota en `03-Aplicaciones/` + `04-Empresas/`.
 2. Identificar contacto objetivo → nota en `05-Contactos/`.
-3. `/cv-tailor` → CV custom partiendo del perfil base + research.
-4. `/cv-ats-export` → PDF ATS a `02-CVs/exports/`.
-5. `/cover-letter` → mensaje de aplicación custom.
-6. `/cold-outreach` → si hay contacto al que escribirle directo.
-7. Cuando haya entrevista → `/interview-prep`.
+3. `/job-aplicar` → pipeline completo de la postulación: CV custom + cover + review (regla drafter-reviewer) + PDF ATS verificado. (A mano: `/cv-tailor` → `/cv-ats-export` → `/cover-letter`.)
+4. `/cold-outreach` → si hay contacto al que escribirle directo.
+5. Enviar la postulación (**siempre manual**) → `/job-outcome <empresa>` para marcar `aplicado`; registrar ahí cada avance.
+6. Cuando haya entrevista → `/interview-prep`.
+7. Con rechazos acumulados → `/job-upskill` para el plan de estudio según gaps reales.
 
 ## Reglas
 
-- Nunca reorganizar carpetas ni renombrar notas sin preguntar — rompe `[[wikilinks]]` en silencio.
+- Nunca reorganizar carpetas ni renombrar notas sin preguntar - rompe `[[wikilinks]]` en silencio.
 - Nunca commitear datos sensibles (CV con teléfono/dirección, salarios, emails de recruiters) a un remoto sin confirmación explícita.
 - Si una categoría necesita un template que no existe, proponerlo antes de inventarlo.
 - Preservar los prefijos numéricos al crear archivos dentro de las carpetas ordenadas.

package/skills/job-hunt/references/templates/Aplicacion.md

@@ -4,7 +4,8 @@ empresa:
 perfil: 
 cv_usado: 
 estado: interesado
-score: 
+match_score: 
+fuente: 
 fecha_aplicacion: 
 fecha_actualizacion: {{date:YYYY-MM-DD}}
 link_oferta: 
@@ -14,6 +15,7 @@ modalidad:
 ubicacion: 
 prioridad: media
 ---
+%% estado: interesado -> aplicado -> entrevista -> oferta | cierres: contratado / rechazado / sin_respuesta / declinada / descartado (los mueve /job-outcome) %%
 
 # {{title}}
 
@@ -29,6 +31,8 @@ prioridad: media
 - Perfil base: [[]]
 - Qué de mi experiencia alinea con lo que piden:
   - 
+- Gaps reales (alimentan /job-upskill):
+  - 
 
 ## A quién escribirle / contacto principal
 - [[]]
@@ -39,7 +43,7 @@ prioridad: media
 - [[]]
 
 ## Timeline / seguimiento
-- {{date:YYYY-MM-DD}} — creada la nota
+- {{date:YYYY-MM-DD}} - creada la nota
 
 ## Entrevistas
 - 

package/skills/job-hunt/references/templates/CV Custom.md

@@ -9,7 +9,7 @@ archivo_pdf:
 archivo_final: 
 ---
 
-# CV custom — {{title}}
+# CV custom - {{title}}
 
 ## Contexto de la postulación
 - **Aplicación:** [[]]

package/skills/job-hunt/references/templates/Contacto.md

@@ -21,7 +21,7 @@ ultima_interaccion: {{date:YYYY-MM-DD}}
 
 
 ## Historial de interacciones
-- {{date:YYYY-MM-DD}} — creada la nota
+- {{date:YYYY-MM-DD}} - creada la nota
 
 ## Mensajes intercambiados
 

package/skills/job-hunt/references/templates/Dashboard.md

@@ -2,7 +2,7 @@
 tipo: dashboard
 ---
 
-# Dashboard — Búsqueda laboral
+# Dashboard - Búsqueda laboral
 
 > Índice del workspace. Cuando haya datos (aplicaciones, entrevistas), estas secciones pueden convertirse en queries dinámicas con Bases/Dataview si usás Obsidian.
 
@@ -16,6 +16,9 @@ tipo: dashboard
 **Cerradas / descartadas:**
 - 
 
+## Leyenda de estados
+⬜ interesado · ✅ aplicado · 📅 entrevista/oferta · ❌ rechazado/sin_respuesta/declinada · 🚫 descartado/cerrada
+
 ## Próximas entrevistas
 - 
 
@@ -26,20 +29,21 @@ tipo: dashboard
 - 
 
 ## Accesos rápidos por carpeta
-- `01-Perfiles/` — perfiles profesionales base + perfil maestro
-- `02-CVs/` — versiones de CV (incluye CVs custom por postulación)
-- `03-Aplicaciones/` — una nota por postulación
-- `04-Empresas/` — research de empresas
-- `05-Contactos/` — recruiters, referidos, hiring managers
-- `06-Entrevistas/` — prep y feedback por ronda
-- `07-Recursos/` — cover letters reutilizables, links útiles
-- `portfolio/` — source-of-truth del portfolio web
-- `Templates/` — plantillas con frontmatter
+- `01-Perfiles/` - perfiles profesionales base + perfil maestro
+- `02-CVs/` - versiones de CV (incluye CVs custom por postulación)
+- `03-Aplicaciones/` - una nota por postulación
+- `04-Empresas/` - research de empresas
+- `05-Contactos/` - recruiters, referidos, hiring managers
+- `06-Entrevistas/` - prep y feedback por ronda
+- `07-Recursos/` - cover letters reutilizables, links útiles
+- `portfolio/` - source-of-truth del portfolio web
+- `Templates/` - plantillas con frontmatter
+- `tools/` - cv_export.py, verify_pdf.py y job_scraper/seen_jobs.json
 
 ## Workflow estándar para una nueva oportunidad
-1. `/job-search` — encontrar y scorear la oferta → nota en `03-Aplicaciones/` + `04-Empresas/`.
+1. `/job-scrape` - corrida de búsqueda con dedup (o `/job-search` para una oferta puntual) → nota en `03-Aplicaciones/` + `04-Empresas/`.
 2. Identificar contacto objetivo → nota en `05-Contactos/`.
-3. `/cv-tailor` — CV custom desde el perfil base + research.
-4. `/cv-ats-export` — PDF ATS a `02-CVs/exports/`.
-5. `/cover-letter` — mensaje de aplicación custom.
-6. `/interview-prep` — cuando haya entrevista.
+3. `/job-aplicar` - pipeline completo: CV custom + cover + review + PDF ATS verificado.
+4. Enviar (siempre manual) → `/job-outcome <empresa>` para marcar `aplicado` y registrar avances.
+5. `/interview-prep` - cuando haya entrevista.
+6. `/job-upskill` - con rechazos acumulados, plan de estudio según gaps reales.

package/skills/job-hunt/references/templates/Perfil.md

@@ -13,10 +13,10 @@ regla_seniority:
 fuentes: []
 ---
 
-# Perfil — {{title}}
+# Perfil - {{title}}
 
 ## Resumen
-> 2–3 líneas: quién sos para este rol y qué te hace fuerte.
+> 2-3 líneas: quién sos para este rol y qué te hace fuerte.
 
 ## Stack principal
 - 

package/skills/job-outcome/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: job-outcome
+description: "Record the outcome or progress of a job application (interview, offer, hired, rejected, no reply) updating the application note and the dashboard. Triggers: me respondieron de, registrar resultado, me rechazaron, tengo entrevista con, recibi una oferta, no me contestaron, actualizar estado de la postulacion."
+argument-hint: "[empresa]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Write, Edit
+---
+
+# /job-outcome - Registrar resultado de una aplicación
+
+Registrá qué pasó con una postulación: avances (entrevista agendada/hecha, oferta recibida) o resoluciones (contratado, rechazado, sin respuesta, oferta declinada, descartado). Adaptado del `/outcome` de MadsLorentzen/ai-job-search al esquema de notas del career workspace (rutas relativas al workspace: `--workspace`, env `CAREER_WORKSPACE`, o `./career-workspace/`).
+
+Empresa/oferta indicada: `$ARGUMENTS`
+
+## Pasos
+
+1. **Localizar la nota.** Buscar en `03-Aplicaciones/` la nota cuyo nombre o frontmatter `empresa` matchee (case-insensitive) con `$ARGUMENTS`. Si no se pasó argumento o hay ambigüedad, listar las aplicaciones con estado abierto (`interesado`, `aplicado`, `entrevista`, `oferta`) y preguntar cuál.
+
+2. **Recolectar qué pasó.** Preguntar al usuario y clasificar:
+   - **Progreso:** entrevista agendada / entrevista realizada / oferta recibida → estados `entrevista` u `oferta`.
+   - **Resolución:** `contratado` · `rechazado` · `sin_respuesta` · `declinada` (la oferta la rechazó el usuario) · `descartado` (el usuario perdió interés / la oferta cerró).
+   Registrar fecha, feedback textual recibido y lecciones aprendidas. **Registrar datos, no interpretarlos:** citar el feedback tal como llegó, sin suavizarlo ni analizarlo acá.
+
+3. **Actualizar la nota de aplicación**, con approval del usuario sobre lo recolectado (idempotente - agregar, nunca duplicar ni sobrescribir):
+   - Frontmatter: `estado` al nuevo valor y `fecha_actualizacion` a hoy. Compatibilidad: si la nota vieja usa `score:` en vez de `match_score:`, no renombrar el campo, solo tocar `estado`.
+   - `## Timeline / seguimiento`: agregar línea `- YYYY-MM-DD - <qué pasó>`.
+   - Si hubo entrevista: entrada en `## Entrevistas` (fecha, etapa, entrevistador si se sabe, y link a la nota de `06-Entrevistas/` si existe).
+   - Feedback y lecciones van en `## Notas`.
+
+4. **Actualizar el dashboard** (`00-Dashboard.md`): buscar la fila de la oferta y actualizar la columna **Estado** con el nuevo estado (usar la leyenda de emojis de abajo, la misma del template Dashboard) y la columna de nota si aporta (ej. "Rechazada 2026-07-13").
+
+5. **Sugerir siguiente paso** según el caso:
+   - `entrevista` → ofrecer `/interview-prep`.
+   - `rechazado` con feedback → anotar la lección en la nota; si se acumulan 3+ resoluciones, ofrecer `/job-upskill` y revisar los criterios de búsqueda contra los resultados reales.
+   - `sin_respuesta` a los 10-14 días → ofrecer follow-up con `/cold-outreach`.
+   - `contratado` → 🎉 y actualizar el resto de las aplicaciones abiertas (¿retirarse de procesos?).
+
+6. **Confirmar** al usuario qué se registró (nota, campos tocados, fila del dashboard).
+
+## Vocabulario de `estado` (frontmatter)
+
+`interesado → aplicado → entrevista → oferta` y cierra en: `contratado | rechazado | sin_respuesta | declinada | descartado`
+
+Emojis del dashboard: ⬜ interesado · ✅ aplicado · 📅 entrevista/oferta · ❌ rechazado/sin_respuesta/declinada · 🚫 descartado/cerrada
+
+## Reglas
+
+- No editar en masa notas existentes: solo la nota de la aplicación en cuestión y su fila del dashboard.
+- No inventar datos: si falta información (fecha, feedback), preguntar o dejar el campo como está.
+- Sin guiones largos en todo texto agregado.
+
+## Handoff
+
+Registro COMPLETE cuando nota y dashboard quedaron consistentes. Según el resultado, el siguiente paso es `/interview-prep` (entrevista agendada), `/cold-outreach` (follow-up) o `/job-upskill` (rechazos acumulados).

package/skills/job-scrape/SKILL.md

@@ -0,0 +1,95 @@
+---
+name: job-scrape
+description: "Search job boards (bundled LinkedIn + GetOnBoard CLIs) with dedup memory across runs, score new openings against a role profile and offer to create application notes. Triggers: buscar ofertas nuevas, scrape de ofertas, correr los CLIs de busqueda, buscar trabajo en LinkedIn o GetOnBoard, nueva corrida de busqueda, ofertas con dedup."
+argument-hint: "[perfil] [--jobage N]"
+category: "career"
+user-invocable: true
+allowed-tools: Read, Glob, Grep, Bash, Write, Edit
+---
+
+# /job-scrape - Búsqueda de ofertas con memoria
+
+Corre los CLIs de búsqueda bundleados (LinkedIn + GetOnBoard, en `scripts/`) con los criterios de un perfil, deduplica contra `seen_jobs.json` y contra las notas existentes, scorea lo nuevo y ofrece crear notas de aplicación. Adaptado del skill job-scraper de MadsLorentzen/ai-job-search.
+
+Flags y datos que devuelve cada script: `references/linkedin-cli.md` y `references/getonbrd-cli.md`.
+
+Argumentos: `$ARGUMENTS` (perfil, opcional; `--jobage N` para override de recencia, default 7 días).
+
+Todas las rutas de notas son relativas al **career workspace** (flag `--workspace`, env `CAREER_WORKSPACE`, o `./career-workspace/`; lo crea `/job-hunt setup`). El estado de dedup vive en `<workspace>/tools/job_scraper/seen_jobs.json`.
+
+## Requisitos
+
+- **Python 3** en el PATH (los scripts usan solo la stdlib: cero dependencias, sin build, sin venv).
+- Career workspace con al menos un perfil en `01-Perfiles/`.
+- Opcional: skill `job-search` instalado (aporta la rúbrica de scoring completa).
+
+## Pasos
+
+1. **Perfil y criterios.** Si `$ARGUMENTS` no matchea una nota de `01-Perfiles/` (excluir `_index`), listar los perfiles y preguntar cuál usar. Leer del frontmatter: `keywords`, `keywords_excluir`, `match_score_minimo`, `salario_minimo_usd_mes`, `modalidad`, `seniority`, `regla_seniority`, `mercado_objetivo`.
+
+2. **Cargar estado.** Leer `<workspace>/tools/job_scraper/seen_jobs.json` (si no existe, crearlo con el esqueleto de `references/seen_jobs.schema.json`; si hay notas previas en `03-Aplicaciones/`, ofrecer backfillearlas como `nota_creada`). Validar que toda entrada `nota_creada` apunte a una nota existente en `03-Aplicaciones/`; reportar punteros rotos sin frenar.
+
+3. **Derivar queries.** 3-5 queries con forma de rol desde las keywords del perfil (ej. "fullstack developer", "backend developer"), no fragmentos de skill sueltos.
+
+4. **CONFIRMACIÓN: correr los CLIs.** Antes de la primera corrida de la sesión, mostrar el warning y pedir approval explícito (mismo criterio que `/job-search` con Apify):
+
+   > ⚠️ El CLI de LinkedIn lee páginas públicas de LinkedIn. El acceso automatizado va **contra sus Terms of Service**, y el uso es a tu propia responsabilidad: personal, volumen bajo, nunca comercial ni barridos masivos. GetOnBoard usa su API pública v0 y no tiene esta restricción.
+   > ¿Corro ambos CLIs, solo GetOnBoard, o ninguno?
+
+   Si el usuario elige solo GetOnBoard, saltear LinkedIn y declarar la cobertura reducida en el resumen final.
+
+5. **Ejecutar los CLIs** (tolerar el fallo de uno y reportar la degradación):
+   ```
+   python .claude/skills/job-scrape/scripts/linkedin_search.py search -q "<query>" -l "<location>" --remote remote --jobage <N> --format json
+   python .claude/skills/job-scrape/scripts/getonbrd_search.py search -q "<query>" --jobage <N> --brief
+   ```
+   La `<location>` de LinkedIn sale del `mercado_objetivo` del perfil; si es worldwide, usar además `-l "Remote"`. Volumen bajo: máximo ~5 queries por CLI por corrida.
+
+   **`--brief` no es opcional en el barrido:** los JD completos son ~80% del payload de GetOnBoard (~58 KB por query), y el quick score del paso 8 solo necesita los campos estructurados + el arranque de la description. El JD completo se trae en el paso 9, solo para las `high`. Si el CLI de LinkedIn emite un `warning` `NO_CARDS_PARSED` en stderr, la respuesta traía contenido pero el markup cambió: reportarlo como degradación de esa fuente, no como "no hay ofertas".
+
+6. **Normalizar y dedup intra-batch.** Canonicalizar URLs (sin utm/tracking; LinkedIn → `jobs/view/<id>`; GetOnBoard `/empleos/` → `/jobs/`), calcular `job_key = slug(empresa)|slug(titulo)` (reglas exactas en `references/dedup-playbook.md`). Misma oferta en ambas fuentes = una entrada con dos `sources[]`.
+
+7. **Dedup contra historial:**
+   - `seen_jobs.json`: entradas `nota_creada` o `descartado` se omiten de la tabla (contarlas aparte); entradas `new` re-vistas actualizan `last_seen` y se muestran marcadas "vista antes, sin decisión".
+   - `03-Aplicaciones/`: Grep por `link_oferta` con las URLs canónicas y por nombre `<Empresa> - <Rol>`. Si hay match no registrado en seen_jobs, registrarlo como `nota_creada` (autocuración).
+   - Matching blando (misma empresa + títulos muy parecidos): mostrar warning "posible duplicado de [[nota]]", no dedup automático.
+
+8. **Quick score (todas las nuevas)** usando solo datos del listing:
+   - `low`: keyword de `keywords_excluir` en el título (o en la description truncada de GetOnBoard); seniority fuera de banda (aplicando `regla_seniority` del perfil si existe); `salary_max < salario_minimo_usd_mes`; o elegibilidad bloqueada (countries/remote_zone excluye el país del usuario según `mercado_objetivo`).
+   - `high`: título matchea keywords del perfil + seniority en banda + sin bloqueos.
+   - `medium`: el resto. Campos null = desconocido, no penalizar.
+
+9. **Score completo solo para las `high`**, con la rúbrica de `.claude/skills/job-search/references/scoring-rubric.md` (si el skill job-search no está instalado, quedarse con el quick score y avisar). El JD completo se trae con `detail` de la fuente que corresponda (`detail <slug>` en GetOnBoard, `detail <id>` en LinkedIn), con un **cap de ~10 fetches por corrida sumando ambas fuentes** (ToS, volumen bajo), priorizando por quick score y recencia. Si las `high` exceden el cap, scorear las que entren y listar el resto con su quick score, declarando el corte.
+
+10. **Presentar tabla** ordenada por score: Título | Empresa | Fuente(s) | Salario | Score | Veredicto. Preguntar si alguna se descarta ya (registrar `status: descartado` + `descarte_motivo`).
+
+11. **Persistir** todas las entradas nuevas/actualizadas en `seen_jobs.json` y actualizar el campo `actualizado`. JSON válido siempre (es un data file con schema).
+
+12. **Ofrecer crear notas** para las de score ≥ `match_score_minimo`, con approval explícito **por oferta** (o "todas") antes de escribir. Por cada confirmada:
+    - Nota en `03-Aplicaciones/<Empresa> - <Rol>.md` desde el template `Templates/Aplicacion.md` del workspace, frontmatter completo (`estado: interesado`, `match_score`, `fuente`, `link_oferta`, `salario_rango`, `modalidad`, `ubicacion`, `prioridad`) y sección "Match con mi perfil" con alineaciones y **gaps reales** (alimentan `/job-upskill`).
+    - Fila en `00-Dashboard.md`, sección de aplicaciones activas, respetando las columnas exactas del header y escapando `\|` en wikilinks con alias.
+    - Entrada seen_jobs → `status: nota_creada` + `nota`.
+
+13. **Resumen final:** contadores (encontradas / ya vistas / nuevas / descartadas / notas creadas), fuentes efectivamente consultadas y cortes aplicados (cap de `detail`, fuente degradada), y sugerencia de `/job-aplicar` para las top.
+
+## Qué NO hace
+
+- No corre el CLI de LinkedIn sin la confirmación del paso 4.
+- No crea notas sin confirmación individual.
+- No genera CVs ni covers (eso es `/job-aplicar`).
+- No marca `estado: aplicado` nunca.
+- No edita notas existentes ni re-scorea ofertas ya con nota.
+- No borra filas del dashboard ni entradas de seen_jobs.
+- No se corre en loop ni excede los caps de volumen.
+
+## Reglas
+
+- Respetar la matriz de fuente de verdad de `references/dedup-playbook.md`: seen_jobs → nota → dashboard, unidireccional.
+- Notas nuevas en el idioma del workspace, sin guiones largos, con wikilinks.
+- Volumen bajo siempre en LinkedIn (el acceso automatizado va contra sus ToS; uso personal y puntual), y con el warning + approval del paso 4 en la primera corrida de la sesión. El profile pre-aprueba el permiso de Bash, no la decisión: la confirmación la pide el skill.
+- `--brief` en el barrido de GetOnBoard; el JD completo solo vía `detail` para las `high`.
+- Si ambos CLIs fallan, frenar y reportar (no degradar a scraping manual sin avisar).
+
+## Handoff
+
+Al cerrar la corrida, las ofertas con nota creada quedan READY para el pipeline de postulación: correr `/job-aplicar <nota|url>` con la mejor. Para gaps recurrentes detectados en los scores, `/job-upskill`.

package/skills/job-scrape/references/dedup-playbook.md

@@ -0,0 +1,25 @@
+# seen_jobs - estado de deduplicacion de /job-scrape
+
+`seen_jobs.json` registra todas las ofertas vistas por `/job-scrape` para no volver a presentarlas en corridas siguientes. Schema formal en `seen_jobs.schema.json` (junto a este archivo). Vive en `<workspace>/tools/job_scraper/` (no entre las notas) porque es dato de maquina, no nota: el vault/Obsidian no lo indexa.
+
+## Matriz de fuente de verdad (regla anti-divergencia)
+
+| Dato | Fuente de verdad | Quien escribe |
+|---|---|---|
+| "Ya vi esta oferta" + triage + descartes pre-nota | `seen_jobs.json` | `/job-scrape` (y `/job-aplicar` al crear o descartar) |
+| Estado del pipeline (`interesado -> aplicado -> ...`), match_score definitivo | Frontmatter de la nota en `03-Aplicaciones/` | `/job-aplicar` crea; `/job-outcome` actualiza |
+| Vista humana de la cola | `00-Dashboard.md` | Derivado de las notas; `/job-aplicar` y `/job-outcome` fila a fila |
+
+El flujo es **unidireccional**: seen_jobs -> nota -> dashboard. Cuando una entrada pasa a `status: nota_creada` se congela (solo conserva el puntero `nota`); el pipeline sigue en la nota y NUNCA se sincroniza de vuelta. Por eso no existe el estado `aplicado` en este archivo.
+
+## Claves de dedup
+
+1. **URL canonica** (por fuente): sin utm/tracking params; LinkedIn reducido a `linkedin.com/jobs/view/<id>`; GetOnBoard `/empleos/` -> `/jobs/`.
+2. **`job_key`** = `slug(empresa)|slug(titulo)`: lowercase, sin acentos, sin puntuacion (conserva `.` interno: coderslab.io, .net), sin sufijos legales (inc, llc, sa...), sin calificadores del titulo entre parentesis ("(remote)", "(latam)"). Detecta la misma oferta publicada en dos fuentes con URLs distintas; se agrega a `sources[]` de la entrada existente en vez de duplicar.
+3. Matching blando (misma empresa + alto solapamiento de tokens del titulo) = **warning** en `/job-scrape`, nunca dedup automatico (una empresa puede tener dos roles parecidos legitimos, o el mismo rol con titulo traducido).
+
+## Mantenimiento
+
+- **Punteros rotos:** `/job-scrape` valida al arrancar que toda entrada `nota_creada` apunte a una nota existente y reporta las rotas.
+- **Poda (opt-in):** entradas `new`/`descartado` con `last_seen` de mas de 90 dias se pueden borrar. Solo a pedido del usuario, nunca automatico. Las `nota_creada` no se podan (son el historial de dedup contra aplicaciones reales).
+- **Primer run:** el archivo arranca vacio (esqueleto del schema). Si ya existen notas en `03-Aplicaciones/`, `/job-scrape` ofrece backfillearlas como `nota_creada` (con `quick_score: null` y `url: "nota://<archivo>"` si la nota no tiene `link_oferta`).

package/skills/job-scrape/references/getonbrd-cli.md

@@ -0,0 +1,62 @@
+# GetOnBoard Search CLI
+
+Busca ofertas en GetOnBoard (job board tech de LATAM) via su API pública v0. Sin auth, sin API key, **cero dependencias**: solo la stdlib de Python 3. Espejo del contrato de `linkedin_search.py` para que `/job-scrape` pueda usar ambos de forma intercambiable.
+
+El script es `scripts/getonbrd_search.py`. Construido a medida siguiendo el patrón `/add-portal` de MadsLorentzen/ai-job-search (investigar endpoint → scaffold con el mismo contrato → test en vivo), y portado de TypeScript a Python por la regla de lenguaje por capa (`docs/coding-standards.md`); la salida de las dos versiones se comparó campo por campo sobre las mismas queries: identica.
+
+## Uso
+
+### Buscar ofertas
+
+```bash
+python .claude/skills/job-scrape/scripts/getonbrd_search.py search -q "<keywords>" [flags]
+```
+
+Flags:
+- `-q / --query <texto>` - **requerido**, minimo 3 chars. La API hace AND de todos los terminos.
+- `--jobage <dias>` - publicada en los ultimos N dias (filtro client-side sobre `published_at`).
+- `--remote <modo>` - `remote` | `hybrid` | `onsite` (filtro client-side).
+- `--page <n>` - paginacion (20 resultados por pagina).
+- `-n / --limit <n>` - tope de resultados (`0` no emite ninguno).
+- `--brief` - solo en `json`: trunca cada `description` a 300 chars y marca `description_truncated`. Los JD completos son ~80% del payload, asi que para triage conviene `--brief` y despues `detail` del shortlist.
+- `--format json|table|plain` - default `json`.
+
+Sin flag `--location`: GetOnBoard es LATAM/remoto por naturaleza; filtrar con `--remote` y leer `countries` en el JSON.
+
+### Detalle de una oferta
+
+```bash
+python .claude/skills/job-scrape/scripts/getonbrd_search.py detail <slug|url> [--format json|plain]
+```
+
+Acepta el `ID` (slug) de los resultados de search o cualquier URL de getonbrd.com (`/jobs/...` o `/empleos/...`, con o sin categoria). Dos capas:
+1. **Search API** (queries progresivas derivadas del slug): datos completos, incluye `applications_count`.
+2. **Microdata fallback** (pagina SSR, schema.org JobPosting): para ofertas viejas o fuera del indice. Detecta y marca ofertas **CERRADAS**.
+
+## Datos que devuelve (JSON)
+
+`id` (slug), `title`, `company`, `location`, `date` (ISO), `url`, `seniority` (Junior/Semi Senior/Senior/Expert), `remote`, `remote_modality` (`remote_local`/`hybrid`/`no_remote`...), `remote_zone`, `countries`, `salary_min_usd_month`/`salary_max_usd_month` (USD/mes cuando esta publicado), `applications_count` (util para la dimension "calidad de la oferta" de la rubrica), `description` (texto plano).
+
+## Ejemplos
+
+```bash
+# Fullstack, ultimas 2 semanas
+python .claude/skills/job-scrape/scripts/getonbrd_search.py search -q "fullstack developer" --jobage 14 --format table
+
+# Triage barato: estructurado completo, JD truncado
+python .claude/skills/job-scrape/scripts/getonbrd_search.py search -q "fullstack developer" --jobage 14 --brief
+
+# .NET remoto
+python .claude/skills/job-scrape/scripts/getonbrd_search.py search -q ".NET developer" --remote remote --format table
+
+# JD completo de una oferta
+python .claude/skills/job-scrape/scripts/getonbrd_search.py detail "https://www.getonbrd.com/jobs/programming/full-stack-developer-buildwithin-remote-b1ef" --format plain
+```
+
+## Notas
+
+- API publica en beta (`api/v0`); si cambia, el fallback de microdata sigue funcionando.
+- Errores a **stderr** como `{ "error": "...", "code": "..." }` con exit code `1`.
+- Volumen bajo por cortesia; la API es publica pero no esta pensada para bulk scraping.
+- Referencia de endpoints: `getonbrd-urls.md`.
+- Tests de los parsers: `tests/job_scrape/test_getonbrd_search.py` en el repo de Arcane.

package/skills/job-scrape/references/getonbrd-urls.md

@@ -0,0 +1,37 @@
+# GetOnBoard API v0 - referencia de endpoints (verificada 2026-07-13)
+
+Base: `https://www.getonbrd.com/api/v0` - sin autenticacion para endpoints publicos. Formato JSON:API.
+
+## Search de ofertas
+
+```
+GET /search/jobs?query=<q>&per_page=<n>&page=<n>&expand[]=seniority&expand[]=company
+```
+
+- `query`: requerido, min 3 chars. Hace AND de todos los terminos (queries largas sobre-restringen).
+- `per_page` / `page`: paginacion; `meta: { page, per_page, total_pages }` en la respuesta.
+- `expand[]`: resuelve las referencias `seniority` y `company` inline (sin expand vienen solo como `{id, type}`).
+
+Respuesta por job (`data[]`): `id` = slug, `links.public_url`, y en `attributes`:
+`title`, `description` (HTML), `functions` (HTML), `desirable` (HTML), `benefits` (HTML), `remote` (bool), `remote_modality` (`remote_local` | `hybrid` | `no_remote` | ...), `remote_zone`, `countries[]`, `min_salary`/`max_salary` (USD/mes, null si no publican), `published_at` (unix), `applications_count`, `seniority.data.attributes.name`, `company.data.attributes.name`, `lang`, `perks[]`.
+
+## Catalogos publicos
+
+```
+GET /seniorities   -> Junior=2, Semi Senior=3, Senior=4, Expert=5, Sin experiencia=1
+GET /categories    -> categorias (programming, design-ux, etc.)
+```
+
+## Lo que NO es publico
+
+- `GET /jobs/<slug>` devuelve **401** (endpoint privado, requiere API key de cuenta).
+  Por eso `detail` del script usa search + filtro por id exacto, con fallback a microdata.
+
+## Paginas SSR (fallback de detail)
+
+- `https://www.getonbrd.com/jobs/<slug>` redirige 301 a `/jobs/<categoria>/<slug>`.
+- La pagina renderiza microdata schema.org JobPosting via atributos `itemprop`:
+  `title`, `hiringOrganization > name`, `datePosted`, `baseSalary > minValue/maxValue`,
+  `description`, `qualifications` (seniority), `address`.
+- Ofertas cerradas: pierden el `itemtype="http://schema.org/JobPosting"` pero conservan
+  los `itemprop`; la pagina contiene el texto "Closed job" / "No longer accepting".

package/skills/job-scrape/references/linkedin-cli.md

@@ -0,0 +1,64 @@
+# LinkedIn Search CLI
+
+Busca ofertas en el job board publico de LinkedIn (endpoints `jobs-guest`) para cualquier pais/region y remoto. Sin autenticacion, sin API key, **cero dependencias**: solo la stdlib de Python 3.
+
+El script es `scripts/linkedin_search.py`. Portado del CLI en TypeScript vendoreado de [MadsLorentzen/ai-job-search](https://github.com/MadsLorentzen/ai-job-search) (`.agents/skills/linkedin-search/`): los scripts de skill corren en el proyecto del usuario sin build step, y TypeScript ahi implica exigir Node 24+ para el type stripping nativo (ver `docs/coding-standards.md`). La traduccion se verifico comparando la salida de las dos versiones sobre el mismo HTML y el mismo detalle: identica.
+
+Diferencias respecto del upstream, todas deliberadas:
+- `normalize_id` acepta el slash final: la URL del boton de compartir es `/jobs/view/<id>/?refId=...` y el regex original solo anclaba en `?`.
+- Warning `NO_CARDS_PARSED` a stderr cuando la respuesta trae contenido pero se parsean 0 cards (cambio de markup vs "no hay ofertas").
+- `&nbsp;` se normaliza a espacio comun: U+00A0 es invisible y rompe el matching de keywords en el JD.
+- Salida UTF-8 forzada: en Windows `stdout` es cp1252 y cualquier acento del JD reventaba al redirigir.
+
+## ⚠️ Uso personal, volumen bajo
+
+Lee paginas publicas de LinkedIn; el acceso automatizado va contra sus Terms of Service. **Mantener volumen bajo** (busquedas puntuales, no barridos masivos ni uso comercial). El script reintenta 429/5xx con backoff exponencial. `/job-scrape` pide confirmacion explicita antes de la primera corrida de la sesion.
+
+## Comandos
+
+### Buscar ofertas
+
+```bash
+python .claude/skills/job-scrape/scripts/linkedin_search.py search -l "<lugar>" [flags]
+```
+
+Flags:
+- `-l / --location <texto>` - **requerido.** Place string de LinkedIn: `"Spain"`, `"European Union"`, `"Remote"`, `"Berlin, Germany"`.
+- `-q / --query <texto>` - keywords (titulo, skill, rol). Recomendado.
+- `--jobage <dias>` - publicado en los ultimos `1`, `7`, `14` o `30` dias.
+- `--remote <modo>` - `remote`, `hybrid` u `onsite`.
+- `--page <n>` - paginacion (10 resultados por pagina).
+- `-n / --limit <n>` - tope de resultados emitidos (`0` no emite ninguno).
+- `--format json|table|plain` - default `json`.
+
+### Detalle completo de una oferta
+
+```bash
+python .claude/skills/job-scrape/scripts/linkedin_search.py detail <id|url> [--format json|plain]
+```
+
+Acepta el ID numerico del search, una URL `jobs/view/...` (con o sin slash final y query params, como la que da el boton de compartir) o un URN. Devuelve descripcion completa, seniority, tipo de empleo, industrias y link.
+
+## Ejemplos
+
+```bash
+# Fullstack remoto en un pais, ultima semana
+python .claude/skills/job-scrape/scripts/linkedin_search.py search -q "full stack developer" -l "Spain" --remote remote --jobage 7 --format table
+
+# Backend .NET remoto en una region
+python .claude/skills/job-scrape/scripts/linkedin_search.py search -q ".NET developer" -l "European Union" --remote remote --jobage 14 --format table
+
+# Game developer remoto global
+python .claude/skills/job-scrape/scripts/linkedin_search.py search -q "game developer" -l "Remote" --jobage 30 --format table
+
+# JD completo de una oferta
+python .claude/skills/job-scrape/scripts/linkedin_search.py detail 4434569000 --format plain
+```
+
+## Notas
+
+- Errores van a **stderr** como `{ "error": "...", "code": "..." }` con exit code `1`. Los diagnosticos no fatales usan la misma forma con clave `warning` (ej. `NO_CARDS_PARSED`) y no cambian el exit code.
+- El search de LinkedIn **no es determinista**: dos corridas seguidas con los mismos parametros pueden devolver ofertas distintas. No asumir que "no aparece" significa "no existe"; el dedup de `/job-scrape` esta justamente para eso.
+- `--format json` sirve para encadenar: sacar IDs y pasarlos a `detail`, o scorear ofertas contra los criterios (`match_score`) antes de crear notas en `03-Aplicaciones/` del career workspace.
+- Referencia de como se construyen las URLs upstream: `linkedin-urls.md`.
+- Tests de los parsers: `tests/job_scrape/test_linkedin_search.py` en el repo de Arcane.

package/skills/job-scrape/references/linkedin-urls.md

@@ -0,0 +1,42 @@
+# LinkedIn Jobs URL Reference
+
+Public, unauthenticated `jobs-guest` endpoints used by this skill. Global — the same
+endpoints serve every market; only the `location` value changes.
+
+> Personal use only — automated access is against LinkedIn's Terms of Service; keep volume low.
+
+## Search
+
+```
+GET https://www.linkedin.com/jobs-guest/jobs/api/seeMoreJobPostings/search
+```
+
+Query params:
+
+| Param | Meaning | Example |
+|-------|---------|---------|
+| `keywords` | Free-text query | `data engineer` |
+| `location` | Place string | `Mumbai, Maharashtra, India` · `Berlin, Germany` · `Remote` |
+| `f_TPR` | Posted-within window (seconds) | `r604800` (7d), `r2592000` (30d) |
+| `f_WT` | Workplace type | `1` on-site · `2` remote · `3` hybrid |
+| `start` | Pagination offset (10/page) | `0`, `10`, `20`, … |
+
+Returns an HTML list of job cards (one `<li>` per posting). The script parses each card by
+its `data-entity-urn="urn:li:jobPosting:<id>"` and extracts title, company, location, date, URL.
+
+## Detail
+
+```
+GET https://www.linkedin.com/jobs-guest/jobs/api/jobPosting/<jobId>
+```
+
+Returns a single job's HTML: title (`top-card-layout__title`), company
+(`topcard__org-name-link`), location (`topcard__flavor--bullet`), the rich description
+(`show-more-less-html__markup` / `description__text`), and job-criteria items
+(seniority, employment type, job function, industries).
+
+## Notes
+
+- No authentication required.
+- Respect rate limits: the script backs off on 429/5xx.
+- Country-agnostic: pass any `--location` (city, region, country, or "Remote").