¿Qué hace Frontend Resume?
Crea páginas HTML de currículum ricas en animaciones y sin dependencias que se ejecutan completamente en el navegador. Ayuda a los usuarios a descubrir su estética preferida mediante la exploración visual y luego genera currículums interactivos de calidad profesional.
Filosofía Central
- Sin Dependencias — Archivos HTML únicos con CSS/JS en línea. Sin npm, sin herramientas de compilación.
- Mostrar, No Decir — Genera vistas previas visuales, deja que los usuarios elijan lo que les gusta.
- Diseño Distintivo — Evita la estética genérica de "contenido de IA". Cada currículum debe sentirse hecho a medida.
- Amigable para Impresión — Cada currículum DEBE incluir estilos
@media printpara una salida PDF limpia. - Accesible — HTML semántico, navegación por teclado, soporte para movimiento reducido, contraste WCAG AA.
Fase 0: Detectar Modo
Determinar lo que el usuario quiere:
Modo A: Desde Archivo — El usuario proporciona un archivo de currículum (.pdf, .docx, .md, .txt, .json) → Fase 1 Modo B: Desde Texto — El usuario proporciona el contenido del currículum como texto → Fase 1 Modo C: Mejora — El usuario tiene un currículum HTML existente para mejorar → Leer archivo, luego Fase 2
Fase 1: Extracción y Estructuración de Contenido
Paso 1.1: Extracción de Archivo (Solo Modo A)
Ejecutar scripts/extract_resume.py en el archivo de currículum del usuario:
python [skill-dir]/scripts/extract_resume.py <resume_file>
Formatos admitidos y dependencias:
| Formato | Extensiones | Dependencia Python | Notas |
|---|---|---|---|
pdfplumber (preferido) o PyPDF2 | pip install pdfplumber | ||
| Word | .docx | python-docx | pip install python-docx |
| Markdown | .md | Ninguna | Analiza encabezados, listas, negrita/cursiva |
| Texto Plano | .txt | Ninguna | Las líneas en MAYÚSCULAS se infieren como encabezados |
| JSON Resume | .json | Ninguna (json incorporado) | Esquema de jsonresume.org; ya estructurado — puede saltar el Paso 1.2 |
Si falta una dependencia requerida, el script imprime instrucciones de instalación.
Presentar el contenido extraído al usuario para su confirmación. Para archivos JSON Resume, los datos ya están estructurados — presentar las secciones mapeadas directamente y saltar al Paso 1.3 a menos que el usuario quiera ajustar.
Paso 1.2: Estructurar Contenido
Analizar el texto sin procesar en secciones estructuradas:
- header: nombre, título/lema, ubicación, contacto (correo electrónico, teléfono, LinkedIn, GitHub, portafolio)
- about: resumen profesional
- experience[]: empresa, rol, fechas, ubicación, viñetas
- education[]: escuela, título, fechas, honores/promedio
- skills{}: agrupadas por categoría con niveles de competencia opcionales (0-100)
- projects[]: nombre, descripción, stack tecnológico, enlace
- certifications[]: nombre, emisor, fecha (opcional)
- languages[]: idioma, competencia (opcional)
Presentar el contenido estructurado al usuario para su revisión. Preguntar: "¿Esto se ve correcto? ¿Alguna sección que agregar, eliminar o modificar?"
Paso 1.3: Prioridad de Sección
Preguntar mediante AskUserQuestion:
- Encabezado: "Diseño"
- Pregunta: "¿Qué secciones deberían ser más prominentes?"
- Opciones:
- "Enfocado en Experiencia" — El historial laboral es la estrella (profesionales senior)
- "Enfocado en Habilidades" — Habilidades técnicas al frente y al centro (desarrolladores/ingenieros)
- "Impulsado por Proyectos" — Portafolio/proyectos destacados (diseñadores/freelancers)
- "Equilibrado" — Mismo peso para todas las secciones
Fase 2: Descubrimiento de Estilo
Paso 2.0: Ruta de Estilo
Preguntar: "¿Cómo te gustaría elegir el estilo de tu currículum?"
- "Muéstrame opciones" — Generar 3 vistas previas visuales (recomendado) → Paso 2.1
- "Sé lo que quiero" — Elegir directamente de una lista predefinida → Mostrar el selector de plantillas a continuación
Plantillas Disponibles:
| Plantilla | Sensación | Mejor para |
|---|---|---|
| Arquitecto Nocturno | Sofisticado, premium | Ejecutivos, consultores |
| Terminal Neón | Estilo hacker, desarrollador | Ingenieros de software, DevOps |
| Lujo Oscuro | Elegante, editorial | Directores creativos, marketing |
| Profundidad Cósmica | Audaz, futurista | Fundadores tecnológicos, ingenieros IA/ML |
| Pizarra Limpia | Minimalista, inspirado en Suiza | Diseñadores, gerentes de producto |
| Artesanía en Papel | Cálido, táctil | Escritores, educadores, académicos |
| Plano Azul Suave | Técnico, accesible | Ingenieros, científicos de datos |
| Mono Brutalista | Crudo, anti-diseño | Estrategas de marca, buscadores de atención |
| Jardín de Salvia | Inspirado en la naturaleza, calmante | RH, bienestar, educadores |
| Tinta Retro | Editorial vintage | Periodistas, marcas personales |
Si el usuario elige una directamente, saltar a la Fase 3.
Paso 2.1: Descubrimiento Guiado
Pregunta 1 — Estado de Ánimo (selección múltiple hasta 2):
- "Profesional/Autoritario" — Establecido, confiable
- "Creativo/Distintivo" — Único, orientado al diseño
- "Moderno/Técnico" — Limpio, orientado a desarrolladores
- "Cálido/Accesible" — Amigable, agradable
Pregunta 2 — Tono:
- "Claro" — Limpio, imprimible
- "Oscuro" — Audaz, optimizado para pantalla
- "Cualquiera" — Deja que el estilo decida
Paso 2.2: Generar 3 Vistas Previas
Basado en el estado de ánimo + tono, seleccionar 3 plantillas. Leer references/STYLE_PRESETS.md para las definiciones completas de las plantillas.
Mapeo estado de ánimo a plantilla:
| Estado de Ánimo | Oscuro | Claro | Especialidad |
|---|---|---|---|
| Profesional | Arquitecto Nocturno, Lujo Oscuro | Pizarra Limpia, Plano Azul Suave | — |
| Creativo | Lujo Oscuro, Profundidad Cósmica | Artesanía en Papel | Mono Brutalista, Tinta Retro |
| Moderno/Técnico | Terminal Neón, Profundidad Cósmica | Plano Azul Suave | Mono Brutalista |
| Cálido | Lujo Oscuro | Artesanía en Papel, Jardín de Salvia | Tinta Retro |
Generar 3 mini vistas previas HTML en .claude-design/resume-previews/:
.claude-design/resume-previews/
├── estilo-a.html
├── estilo-b.html
└── estilo-c.html
Cada vista previa: autónoma (~80-120 líneas), muestra la sección de héroe + una entrada de experiencia + barras de habilidades. Suficiente para transmitir la estética.
NUNCA usar estos patrones genéricos:
- Inter, Roboto, Arial como fuentes para mostrar
- Degradados morados sobre blanco, índigo genérico
#6366f1 - Todo centrado sin variación
- Glassmorphism gratuito
Paso 2.3: Elegir
Presentar vistas previas, preguntar al usuario si quiere elegir una o mezclar elementos.
Fase 3: Generar Currículum
Leer estos archivos de referencia para la plantilla elegida:
references/STYLE_PRESETS.md— Variables CSS completas, URLs de fuentes, paleta de colores, estilo de animaciónreferences/RESUME_COMPONENTS.md— Patrones CSS/JS de componentes interactivosreferences/HTML_ARCHITECTURE.md— Plantilla HTML base, CSS obligatorio, arquitectura JS, estilos de impresión, lista de verificación de accesibilidad
Salida
Generar un único archivo HTML autónomo:
- Todo el CSS en línea en
<style> - Todo el JS en línea en
<script> - Google Fonts / Fontshare mediante
<link>(degradación elegante) - Estructura HTML5 semántica
Características Requeridas
- Revelaciones por desplazamiento — Los elementos aparecen mediante IntersectionObserver
- Navegación flotante — Navegación fija con seguimiento de sección activa
- Barras de habilidades animadas — Se llenan al entrar en la vista
- Barra de progreso de desplazamiento — Barra delgada en la parte superior
- Botón Volver arriba — Aparece después de desplazarse
- Hoja de estilo de impresión —
@media printcon fondo blanco, sin animaciones, URLs visibles - Movimiento reducido —
@media (prefers-reduced-motion: reduce)deshabilita animaciones - Responsivo — Todos los tamaños usan
clamp(), funciona de móvil a escritorio
Lista de Verificación
Antes de entregar, verificar:
- Toda la tipografía usa
clamp(min, preferred, max) - Todo el espaciado usa
clamp()o unidades de viewport - HTML semántico (
<header>,<main>,<section>,<nav>) - Estilos de impresión incluidos y funcionales
- Movimiento reducido respetado
- Etiquetas ARIA en navegación, botones, barra de progreso
- Contraste de color cumple WCAG AA
- Los enlaces externos tienen
target="_blank" rel="noopener"
Fase 4: Entrega
- Limpiar — Eliminar
.claude-design/resume-previews/si existe - Abrir — Iniciar en el navegador:
open [nombre_archivo].html - Resumen:
¡Tu currículum interactivo está listo!
Archivo: [nombre_archivo].html
Estilo: [Nombre del Estilo]
Secciones: [lista]
Características:
- Animaciones activadas por desplazamiento
- Barras de habilidades animadas
- Línea de tiempo interactiva
- Navegación flotante
- Amigable para impresión (Ctrl+P)
- Responsivo en todos los tamaños de pantalla
Para personalizar:
- Colores: Edita las variables CSS :root al inicio
- Fuentes: Cambia el enlace de importación de la fuente
- Animaciones: Modifica los tiempos de la clase .reveal
- Contenido: Edita el texto directamente en el HTML
¿Te gustaría que hiciera algún ajuste?
Solución de Problemas
La extracción de PDF devuelve poco texto: El PDF puede estar basado en imágenes (escaneado). Pide al usuario que proporcione el contenido de texto directamente.
La extracción de DOCX pierde estructura: Algunos archivos DOCX no usan estilos de encabezado estándar (Título 1/2/3). El extractor recurre al tamaño de fuente de ejecuciones individuales. Si la estructura aún no está clara, pide al usuario que confirme qué líneas son encabezados de sección.
Faltan campos en JSON Resume: El JSON puede omitir secciones opcionales (proyectos, certificados, etc.). Presenta lo que está disponible y pregunta al usuario si quiere agregar las secciones faltantes manualmente.
Interferencia de frontmatter en Markdown: Los delimitadores de frontmatter YAML (---) se omiten automáticamente. Si el contenido del currículum usa --- como reglas horizontales, también se omitirán; esto generalmente es inofensivo.
Fuentes que no se cargan: Verifica la URL de la fuente. Asegúrate de que la declaración font-family incluya una fuente de respaldo del sistema.
Animaciones que no se activan: Verifica que IntersectionObserver esté inicializado. Comprueba que se esté agregando la clase .visible.
La salida impresa se ve mal: Asegúrate de que exista el bloque @media print. Verifica que las animaciones estén deshabilitadas y los fondos sean blancos.