¿Qué hace Upskill (Mejora de Habilidades)?
Analiza los trabajos registrados contra el perfil actual del candidato para encontrar brechas de habilidades, luego produce un mapa de calor de brechas y un plan de aprendizaje con recursos de estudio concretos, buscados, y un orden de estudio.
Configuración
- Perfil del candidato:
$JOB_SEARCH_HOME/profile.md - Trabajos registrados:
tracker_pathdesde$JOB_SEARCH_HOME/integrations.yaml - Los informes se escriben en
$JOB_SEARCH_HOME/upskill/
Invocación
/upskill— modo agregado: todas las filas del archivo de seguimiento/upskill <URL>— modo dirigido: una sola oferta, obtenida desde la URL
Paso 1 — Detectar modo
Sin argumento → agregado. Una URL → dirigido; conserva la URL para el Paso 2.
En modo dirigido, deriva un slug de informe a partir del rol y la empresa, p.ej.
<slug-empresa>-<slug-rol>.
Paso 2 — Cargar datos
Agregado
- Leer el archivo de seguimiento. Columnas:
date, company, sector, role, role_type, channel, status, contact_person, fit_rating, notes, cv_file, cover_letter_file, source - Anotar
role,company,fit_ratingpor fila.fit_ratinges 0–100; úsalo para ponderar brechas, ya que una calificación baja significa que el rol expuso más brechas. - Leer
$JOB_SEARCH_HOME/profile.mdpara las habilidades actuales. - Buscar en
$JOB_SEARCH_HOME/upskill/el informe más recientereport-YYYY-MM-DD.md; si existe, cargarlo para la comparación del Paso 8.
Dirigido
- Obtener la oferta mediante WebFetch.
- Extraer título, empresa, habilidades requeridas, habilidades preferidas, responsabilidades, contexto del dominio.
- Leer
$JOB_SEARCH_HOME/profile.md. - No se utilizan datos del archivo de seguimiento.
Paso 3 — Pase 1: Diferencia de habilidades duras
Agregado. No tienes las ofertas completas, así que infiere los requisitos probables a partir de role,
sector y notes. Si source tiene una URL activa, puedes obtenerla; omite las muertas o faltantes.
Construye un mapa de frecuencia de habilidades, luego pondera por ajuste: cada trabajo contribuye
(100 - fit_rating) / 100 por ocurrencia. La puntuación final es la suma de
fit_weight × occurrence entre todos los trabajos.
Dirigido. Toma las habilidades requeridas y preferidas explícitas. Mismo peso. Requeridas antes que preferidas, alfabéticamente dentro de cada grupo.
Diferencia contra el perfil. Elimina cualquier cosa ya presente en profile.md, con generosidad — si
el perfil menciona una habilidad de cualquier forma, no es una brecha. Lo que queda es la lista de brechas de habilidades duras:
ordenada por puntuación en modo agregado, requeridas-antes-que-preferidas luego alfabéticamente en modo dirigido.
Paso 4 — Pase 2: Síntesis
Razonar sobre brechas que la diferencia pasaría por alto:
- Conocimiento del dominio — industria o espacio problemático desconocido
- Habilidades blandas — formas de trabajo, comunicación, liderazgo que el perfil no aborda
- Herramientas y procesos — frameworks, servicios en la nube, metodologías que aparecen en varios trabajos
- Credenciales — una certificación que varias ofertas listan como preferida
Etiqueta cada una como [dominio], [blandas], [herramientas] o [credenciales]. No repitas brechas del Pase 1.
Paso 5 — Mapa de calor de brechas
Combina ambos pases en una tabla priorizada:
- Crítica — habilidades duras altamente ponderadas, o una brecha de dominio en la mayoría de los trabajos
- Alta — habilidades duras moderadas, o brechas consistentes de habilidades blandas/herramientas
- Media — habilidades duras de menor frecuencia, o brechas en menos roles
- Baja — menciones aisladas
| Prioridad | Habilidad / Área | Tipo | Fuente de brecha |
|---|---|---|---|
| Crítica | Kubernetes | Dura | 4/5 trabajos, puntuación 3.2 |
| Alta | Conocimiento del dominio de seguridad | Dominio | Síntesis de LLM |
| Media | AWS (avanzado) | Dura | 2/5 trabajos, puntuación 1.1 |
| Baja | … | … | … |
Imprime esta tabla antes de continuar, para que el usuario pueda ver desde dónde estás trabajando.
En modo dirigido, prioriza según el lenguaje de la propia oferta: requerido → Crítica/Alta, preferido → Media, inferido → Media/Baja.
Paso 6 — Plan de aprendizaje
Cubre cada brecha Crítica y Alta, más Media si hay menos de cinco brechas en total.
Para cada brecha:
- WebSearch recursos actuales y bien valorados. Incluye el año actual en la consulta para que
los resultados no estén desactualizados. Ejemplo:
"mejor curso <habilidad> <año> site:reddit.com OR coursera.org" - Elige 2–3 recursos. Prefiere laboratorios prácticos sobre los solo de clase magistral; documentación oficial para brechas de herramientas; libros para brechas de dominio. Da nombre, URL y una línea sobre por qué encaja.
- Escribe una dirección de estudio adaptada a lo que el candidato ya sabe. Indica qué omitir y por dónde empezar.
- Estima el tiempo hasta la competencia laboral (
~20h). Redondea al alza.
Agrupa bajo encabezados temáticos en lugar de alfabetizar: Nube e Infraestructura, MLOps, Conocimiento del Dominio, Seguridad, Habilidades Blandas y Formas de Trabajo, Certificaciones.
### Nube e Infraestructura
**Kubernetes** `[Dura]` — ~20h
- [Recurso](url) — laboratorios prácticos, más práctico que teórico
- [Documentación oficial](url) — referencia una vez que lo básico esté en su lugar
Dirección de estudio: los conceptos básicos de contenedores ya están cubiertos — comienza con
Planificación de Pods, luego Servicios y Despliegues. Domina los manifiestos y `kubectl` antes
de tocar Helm.
Paso 7 — Orden de estudio sugerido
- Dependencias primero — si B necesita A, coloca A primero y anota la dependencia
- Crítico antes que Alto antes que Medio dentro de un nivel
- Victorias rápidas temprano — una brecha Media rápida puede ir primero para generar impulso
- Conocimiento del dominio al final — estúdialo junto a un proyecto real
| # | Tema | Tipo | Tiempo est. | Nota |
|---|---|---|---|---|
| 1 | Kubernetes | Dura | ~20h | Requerido antes del paso 3 |
| 2 | Pipelines CI/CD | Herramientas | ~10h | |
| 3 | Conocimiento del dominio de seguridad | Dominio | ~15h | Junto a un proyecto real |
Tiempo total estimado: ~45h
Paso 8 — Escribir y guardar el informe
Orden: encabezado y modo → desde el último informe (solo agregado) → mapa de calor de brechas → plan de aprendizaje → orden de estudio sugerido.
- Agregado:
$JOB_SEARCH_HOME/upskill/report-YYYY-MM-DD.md - Dirigido:
$JOB_SEARCH_HOME/upskill/report-YYYY-MM-DD-<slug-empresa>-<slug-rol>.md— minúsculas, espacios a guiones, eliminar caracteres especiales
Sección de diferencia, solo agregado: brechas cerradas son habilidades del mapa de calor anterior ahora presentes en el perfil; nuevas brechas son entradas del mapa de calor actual ausentes en el informe anterior. Omite la sección completa cuando no exista un informe anterior.
Confirma la ruta guardada al usuario.
Reglas
- Nunca inventes recursos. Solo cita lo que WebSearch devolvió realmente.
- Busca con el año actual en cada consulta de recursos.
- El modo dirigido ignora el archivo de seguimiento por completo.
- Sé generoso con la coincidencia del perfil. Una habilidad mencionada de cualquier forma no es una brecha.
- Imprime el mapa de calor antes del plan de aprendizaje.
- No hay recursos de estudio para brechas Bajas a menos que se solicite.
- Siempre guarda el informe, incluso si la salida de terminal pareció suficiente.
- Genera slugs de nombres de empresa a partir de la oferta. No inventes ni adivines uno.