Communitygithub.com

Frontend Resume

Convierte currículums en sitios web HTML de una sola página interactivos y animados con estilos visuales distintivos. Ayuda a los no diseñadores a descubrir su estética a través de la exploración visual.

¿Qué es Frontend Resume?

Esta habilidad permite a un agente de IA transformar currículums vitae (en formatos PDF, DOCX, Markdown, texto plano, JSON Resume o texto directo) en páginas web HTML autónomas, interactivas y con ricas animaciones. Sigue un proceso en cuatro fases: (1) extracción y estructuración del contenido del currículum, (2) descubrimiento del estilo visual mediante la generación de avances o selección directa de una plantilla predefinida, (3) generación del archivo HTML final con todas las funcionalidades requeridas (animaciones, navegación flotante, barras de habilidades animadas, diseño responsivo, soporte de impresión y accesibilidad), y (4) entrega del archivo y resumen de las características. La habilidad se basa en scripts de Python para la extracción de datos (pdfplumber, python-docx) y en la generación de avances HTML previos para que el usuario elija su estilo preferido. Su filosofía principal es "cero dependencias" (archivos HTML autónomos), "mostrar, no decir" (exploración visual) y garantizar la accesibilidad y la imprimibilidad. Es compatible con agentes de IA como Claude Code, Cursor o Codex, y su documentación detallada se encuentra en el archivo SKILL.md.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yukiniro/skills/tree/HEAD/skills/frontend-resume

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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

  1. Sin Dependencias — Archivos HTML únicos con CSS/JS en línea. Sin npm, sin herramientas de compilación.
  2. Mostrar, No Decir — Genera vistas previas visuales, deja que los usuarios elijan lo que les gusta.
  3. Diseño Distintivo — Evita la estética genérica de "contenido de IA". Cada currículum debe sentirse hecho a medida.
  4. Amigable para Impresión — Cada currículum DEBE incluir estilos @media print para una salida PDF limpia.
  5. 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:

FormatoExtensionesDependencia PythonNotas
PDF.pdfpdfplumber (preferido) o PyPDF2pip install pdfplumber
Word.docxpython-docxpip install python-docx
Markdown.mdNingunaAnaliza encabezados, listas, negrita/cursiva
Texto Plano.txtNingunaLas líneas en MAYÚSCULAS se infieren como encabezados
JSON Resume.jsonNinguna (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:

PlantillaSensaciónMejor para
Arquitecto NocturnoSofisticado, premiumEjecutivos, consultores
Terminal NeónEstilo hacker, desarrolladorIngenieros de software, DevOps
Lujo OscuroElegante, editorialDirectores creativos, marketing
Profundidad CósmicaAudaz, futuristaFundadores tecnológicos, ingenieros IA/ML
Pizarra LimpiaMinimalista, inspirado en SuizaDiseñadores, gerentes de producto
Artesanía en PapelCálido, táctilEscritores, educadores, académicos
Plano Azul SuaveTécnico, accesibleIngenieros, científicos de datos
Mono BrutalistaCrudo, anti-diseñoEstrategas de marca, buscadores de atención
Jardín de SalviaInspirado en la naturaleza, calmanteRH, bienestar, educadores
Tinta RetroEditorial vintagePeriodistas, 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 ÁnimoOscuroClaroEspecialidad
ProfesionalArquitecto Nocturno, Lujo OscuroPizarra Limpia, Plano Azul Suave—
CreativoLujo Oscuro, Profundidad CósmicaArtesanía en PapelMono Brutalista, Tinta Retro
Moderno/TécnicoTerminal Neón, Profundidad CósmicaPlano Azul SuaveMono Brutalista
CálidoLujo OscuroArtesanía en Papel, Jardín de SalviaTinta 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ón
  • references/RESUME_COMPONENTS.md — Patrones CSS/JS de componentes interactivos
  • references/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

  1. Revelaciones por desplazamiento — Los elementos aparecen mediante IntersectionObserver
  2. Navegación flotante — Navegación fija con seguimiento de sección activa
  3. Barras de habilidades animadas — Se llenan al entrar en la vista
  4. Barra de progreso de desplazamiento — Barra delgada en la parte superior
  5. Botón Volver arriba — Aparece después de desplazarse
  6. Hoja de estilo de impresión — @media print con fondo blanco, sin animaciones, URLs visibles
  7. Movimiento reducido — @media (prefers-reduced-motion: reduce) deshabilita animaciones
  8. 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

  1. Limpiar — Eliminar .claude-design/resume-previews/ si existe
  2. Abrir — Iniciar en el navegador: open [nombre_archivo].html
  3. 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.

Skills relacionados