Communitygithub.com

RiverAi7z/pdf-resume-skills

Construye un impresionante sitio web personal a partir de un PDF de currículum. Usa esta habilidad cada vez que el usuario quiera crear un sitio web personal, portafolio o currículum en línea desde un PDF. También actívala cuando el usuario mencione convertir un currículum a un sitio web, crear un portafolio desde su CV o quiera una página de aterrizaje personal basada en su trayectoria profesional.

¿Qué es pdf-resume-skills?

Esta habilidad permite construir un sitio web personal de alta calidad y con diseño distintivo a partir de un archivo PDF de currículum vitae. Su propósito es evitar la uniformidad estética común en sitios generados por IA, ofreciendo en su lugar una apariencia única y profesional que refleje la personalidad, profesión y preferencias de diseño del usuario. La habilidad se compone de un flujo de trabajo detallado que incluye la extracción del contenido del PDF (usando un script de Python con `uv` o un MCP de respaldo), el análisis de la trayectoria profesional del usuario para determinar la dirección estética adecuada (tipografía, paleta de colores, animaciones y fondos), y una interacción guiada para recoger las preferencias del usuario de forma adaptativa. La habilidad proporciona pautas muy concretas sobre tipografía, colores, animaciones y fondos, con ejemplos de código CSS y HTML, y una tabla de direcciones estéticas por profesión. Está diseñada para plataformas como Claude Code y otras herramientas de agentes de IA, y su documentación incluye instrucciones detalladas para la extracción de PDF y la generación de previsualizaciones de color en el navegador.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add RiverAi7z/pdf-resume-skills

Preguntar en tu IA favorita

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

Documentación

Constructor de Sitio Web desde Currículum

Construye un sitio web personal distintivo y de calidad profesional a partir de un PDF de currículum. El sitio web debe reflejar la profesión, personalidad y preferencias de diseño del usuario, no parecer una plantilla genérica.


Mandato de Estética de Diseño

Antes de escribir una sola línea de código, internaliza esto: el mayor modo de fracaso en los sitios web generados por IA es la convergencia estética: todos los sitios terminan pareciéndose vagamente. Evita esto a toda costa. Tu trabajo es crear algo que se sienta genuina y específicamente diseñado para esta persona.

Tipografía

Elige fuentes que sean hermosas, inusuales y apropiadas para el campo de la persona. El objetivo es una combinación que alguien notaría y comentaría, no un recurso seguro.

Fuentes prohibidas (tan usadas que se han vuelto invisibles): Inter, Roboto, Arial, Helvetica, system-ui, -apple-system, Space Grotesk, Poppins. Son opciones por defecto, no elecciones.

Fuentes de Google Fuentes distintivas para elegir (elige las adecuadas para la profesión y la estética, no las uses todas):

Serifas Editoriales / Expresivas:

  • Cormorant Garamond — romántica, literaria, lujo editorial de moda
  • Playfair Display — impresión editorial clásica, trazos de alto contraste
  • Fraunces — serifa óptica peculiar, personalidad sorprendente
  • Instrument Serif — refinada y contemporánea, confianza silenciosa
  • DM Serif Display — serifa moderna con fuerza
  • Abril Fatface — ultra alto contraste, titulares impactantes
  • Yeseva One — calidez art déco, autoridad accesible
  • Cinzel — gravedad romana clásica

Sans-Serif Limpias pero Distintivas:

  • Syne — geométrica, vanguardista, contemporánea
  • Unbounded — audaz, perfecta para cuadrículas, nativa web
  • Plus Jakarta Sans — cálida y moderna, distinta de Inter
  • Outfit — geométrica fresca con personalidad
  • DM Sans — limpia pero no estéril
  • Josefin Sans — minimalismo geométrico elegante

Para Cuerpo de Texto (legibles, distintivas):

  • Lora — serifa cálida, literaria, legible en textos largos
  • Source Serif 4 — confiabilidad editorial
  • Spectral — serifa digital elegante
  • Literata — diseñada con precisión para la lectura

Para Estética Técnica / Desarrollador:

  • JetBrains Mono — credibilidad de desarrollador
  • IBM Plex Mono — tecnología corporativa, estructurada
  • Space Mono — retro-digital, carácter
  • Fira Code — ligaduras, estética hacker

Para Estéticas Expresivas / de Nicho:

  • Exo 2 — precisión sci-fi
  • Orbitron — era espacial (úsala con moderación — para la persona adecuada es perfecta)
  • Rajdhani — energía técnica y angular

Principio de combinación: Elige una fuente de visualización/titular y una fuente para el cuerpo. Deben contrastar: un titular serifa de alto drama con un cuerpo sans-serif limpio, o un titular monoespaciado preciso con un cuerpo serifa cálido. Las combinaciones aburridas son aquellas donde ambas fuentes se sienten del mismo peso.

Color y Tema

Comprométete con una paleta fuerte y cohesiva. Las paletas tímidas que distribuyen el color de manera uniforme se sienten amateur. Un color dominante + un acento marcado + neutros cuidadosos es casi siempre más fuerte que tres colores con el mismo peso.

Combinaciones de colores prohibidas (cliché, esperadas):

  • Degradados púrpura/violeta sobre blanco (la estética "IA" por defecto)
  • Teal + coral sobre blanco (paleta de startups sobreutilizada)
  • Modo oscuro genérico: fondo #1a1a1a + texto blanco + acento azul
  • Pasteles planos sin contraste ni tensión

Arquetipos de paletas distintivas para inspirarse (adapta, no copies exactamente):

  • Bosque profundo #1a2e1a + dorado cálido #c9a84c + crema #f5f0e8 — autoridad orgánica
  • Azul marino medianoche #0d1b2a + cian eléctrico #00d4ff + blanco — precisión técnica
  • Negro cálido #1a1208 + ámbar #f59e0b + marfil — calidez editorial
  • Carbón #2a2a2a + óxido #c0392b + blanco roto #fafaf7 — confianza audaz
  • Burdeos profundo #3d0c02 + champán #e8d5b7 + marfil — lujo académico
  • Casi negro #0e0e0e + lima ácida #a8d729 + blanco — vanguardia técnica
  • Pizarra #2c3e50 + coral profundo #ff6b4a + crema — modernismo cálido
  • Blanco roto #fafaf8 + tinta #1a1a2e + terracota #c4602a — calidez terrosa
  • Violeta oscuro #1a0533 + rosa intenso #ff6b9d + blanco — maximalismo creativo

Varía activamente entre temas claros y oscuros entre diferentes usuarios. No optes por defecto por lo oscuro porque "parece más técnico": un sitio claro con una paleta editorial fuerte puede ser igualmente impactante.

Usa propiedades personalizadas de CSS para cada color:

:root {
  --color-bg: #1a2e1a;
  --color-surface: #243824;
  --color-accent: #c9a84c;
  --color-text: #f5f0e8;
  --color-muted: #8a9e8a;
}

Movimiento

Una secuencia de entrada bien orquestada crea más deleite que diez microinteracciones dispersas. Piensa en la carga de la página como un único momento coreografiado.

Patrones efectivos:

/* Revelación escalonada al cargar — aplica con animation-delay creciente */
@keyframes fadeUp {
  from { opacity: 0; transform: translateY(24px); }
  to   { opacity: 1; transform: translateY(0); }
}
.hero-name    { animation: fadeUp 0.6s ease forwards; animation-delay: 0.1s; }
.hero-title   { animation: fadeUp 0.6s ease forwards; animation-delay: 0.25s; }
.hero-tagline { animation: fadeUp 0.6s ease forwards; animation-delay: 0.4s; }
.hero-cta     { animation: fadeUp 0.6s ease forwards; animation-delay: 0.55s; }
  • Usa opacity: 0 como valor por defecto y anima a opacity: 1 — limpio y componible
  • Los estados hover deben usar transition: all 0.2s ease — lo suficientemente rápido para sentirse receptivo
  • Revelaciones activadas por scroll: usa IntersectionObserver + una clase CSS toggle para las secciones que entran al viewport
  • Para bordes, subrayados y resaltados: las transformaciones animadas de width o clip-path se sienten precisas e intencionadas

Evita: efectos de partículas particle.js / canvas, rebotes excesivos, parallax que lucha contra el contenido, animaciones que retrasen la visibilidad del contenido por más de ~1 segundo en total.

Fondos

Los colores sólidos son el perezoso por defecto. Cada fondo debe tener al menos una capa de profundidad o textura.

Técnicas:

/* Degradado de malla — múltiples degradados radiales en capas */
background:
  radial-gradient(ellipse at 20% 50%, rgba(201,168,76,0.15) 0%, transparent 60%),
  radial-gradient(ellipse at 80% 20%, rgba(0,212,255,0.08) 0%, transparent 50%),
  #0d1b2a;

/* Patrón de cuadrícula sutil */
background-image: linear-gradient(rgba(255,255,255,0.03) 1px, transparent 1px),
                  linear-gradient(90deg, rgba(255,255,255,0.03) 1px, transparent 1px);
background-size: 48px 48px;

/* Textura de grano mediante filtro SVG */
filter: url(#grain); /* define el filtro SVG feTurbulence */

/* Acento de rayas diagonales */
background: repeating-linear-gradient(
  -45deg,
  transparent,
  transparent 8px,
  rgba(201,168,76,0.05) 8px,
  rgba(201,168,76,0.05) 9px
);

Adapta la técnica de fondo a la estética general: un sitio de desarrollador con estética de terminal podría usar un sutil efecto de líneas de exploración; un sitio de finanzas de lujo podría usar una textura de lino muy tenue.


Flujo de Trabajo

Paso 1: Extraer el PDF del Currículum

Usa el siguiente enfoque en orden: prueba el script primero, recurre al MCP solo si falla.

Opción A: Script de uv (preferido)

Ejecuta el script de extracción usando uv. Maneja las dependencias automáticamente sin configuración más allá de tener uv instalado.

uv run .claude/skills/resume-website/scripts/pdf-extract.py <ruta-al-curriculum.pdf>

Si uv no está instalado, indica al usuario que lo instale primero:

  • macOS / Linux:
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
  • Windows (PowerShell):
    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
    

Después de instalar, vuelve a ejecutar el comando del script anterior.

Opción B: MCP de pdf-reader (respaldo)

Si el script falla por cualquier motivo, recurre al MCP de pdf-reader. Verifica que esté instalado; si no, instálalo:

claude mcp add pdf-reader -- npx @sylphx/pdf-reader-mcp

Después de instalarlo, reinicia Claude Code para que el MCP esté disponible. Luego usa la herramienta read_pdf del MCP para extraer el contenido del currículum.

Paso 2: Leer y Analizar el Currículum

Usa el MCP de pdf-reader para leer el PDF del currículum del usuario. Extrae y organiza:

  • Nombre e información de contacto (correo electrónico, teléfono, ubicación, LinkedIn, GitHub, enlaces al portafolio)
  • Título profesional / eslogan
  • Experiencia laboral (empresas, roles, fechas, logros)
  • Educación (títulos, instituciones, fechas)
  • Habilidades (técnicas, blandas, idiomas)
  • Proyectos (si los hay)
  • Certificaciones, premios, publicaciones (si las hay)
  • Resumen / objetivo (si lo hay)

Paso 3: Analizar la Profesión del Usuario

El trabajo del usuario determina la dirección estética del sitio web. Adapta el diseño a su identidad profesional, pero ve más allá de la categorización superficial. Un "ingeniero de software" en un fondo de cobertura tiene una estética diferente a uno en una agencia de diseño.

Categoría de ProfesiónDirección EstéticaPunto de Partida TipográficoDirección de Color
Ingeniero de Software / DesarrolladorInspirado en terminal, preciso, preferiblemente oscuroJetBrains Mono o IBM Plex Mono + sans-serif limpiaFondo oscuro + acento eléctrico (cian, verde, ámbar)
Diseñador / Director CreativoAudaz, experimental, fuerte presencia tipográficaSerifa expresiva + sans-serif geométricaAlto contraste, combinaciones inesperadas
Científico de Datos / AnalistaEstructurado, analítico, inspirado en visualización de datosSans-serif precisa + cuerpo serifa legibleAzul marino/pizarra intenso + acento único marcado
Marketing / NegociosSensación de revista editorial, segura, impulsada por CTATitular serifa de alto contraste + sans-serif cálidaDominante cálido + acento audaz
Académico / InvestigadorAcadémico, con mucho uso de serifas, minimalismo intelectualCormorant o Spectral + cuerpo LoraCrema/marfil + tinta + un acento cálido
Salud / MédicoLimpio, confiable, autoridad tranquilaDM Sans o Plus Jakarta Sans + cuerpo legibleNeutro calmante + acento confiable
Finanzas / ConsultoríaLujo, autoridad, refinadoCinzel o Yeseva One + cuerpo serifa eleganteOscuro + dorado/champán o azul marino intenso + plata
Artista / FotógrafoTipo galería, centrado en imágenes, dramáticoAbril Fatface o Syne + cuerpo minimalistaDepende de su trabajo: a menudo casi negro + un color audaz
Gerente de ProductoModerno, organizado, orientado a métricasInstrument Serif + sans-serif limpiaTono medio seguro + acento nítido
Profesor / EducadorCálido, accesible, legibleFraunces o DM Serif + cuerpo sans-serif cálidoPaleta cálida, brillo más alto
LegalAutoritario, tradicional, estructuradoCinzel o Playfair Display + cuerpo serifaAzul marino oscuro o carbón + dorado
Freelance / GeneralistaExpresión de marca personal: usa los detalles del currículum para decidirDepende de su personalidadDepende de su personalidad

Usa esto como punto de partida, luego adapta según lo que el currículum específico revele sobre su personalidad, nivel de experiencia y contexto de la industria.

Paso 4: Preguntar las Preferencias de Diseño del Usuario

Usa la herramienta AskUserQuestion para recopilar las preferencias de diseño. Haz preguntas de manera amigable y no técnica, ya que los usuarios pueden no conocer la terminología de diseño.

El principio clave: cada pregunta debe adaptarse a lo que el usuario ya ha respondido. No agrupes todas las preguntas por adelantado y presentes opciones pregeneradas: las elecciones en preguntas posteriores dependen de lo que el usuario eligió antes. Si preguntas sobre tipografía antes de saber si prefieren claro u oscuro, sugerirás las fuentes equivocadas.

Ronda 1 — La decisión ancla: ambiente + tono

Pregunta sobre el ambiente general y la dirección claro/oscuro juntos, ya que son los dos ejes de los que todo lo demás se deriva. Genera 3-4 direcciones estéticas adaptadas a su profesión (por ejemplo, un ingeniero de software ve "terminal/precisión", un diseñador ve "editorial/expresivo"). Lidera con tu recomendación principal y explica por qué se adapta específicamente a ellos. Incluye una opción "Sorpréndeme".

Una vez que tengas su respuesta, mantenla como el ancla para todo lo que sigue.

Ronda 2 — Color + estilo visual (adaptado a la Ronda 1)

Ahora genera opciones de paleta de colores que realmente funcionen dentro del tema que eligieron. Si eligieron claro, muestra paletas claras, no "aquí tienes 5 opciones, 3 de las cuales son oscuras". Lo mismo para el estilo visual: muestra estilos que sean coherentes con el ambiente que eligieron. Usa los arquetipos de paleta del Mandato de Estética de Diseño como punto de partida y adáptalos.

Mostrando colores visualmente: Antes de hacer la pregunta sobre el color, genera un archivo temporal color_preview.html y ábrelo en el navegador para que el usuario pueda ver muestras reales. Luego pídeles que elijan por nombre/número.

Genera de 3 a 4 opciones de paleta. Cada paleta debe tener: fondo, superficie, acento y colores de texto. Escribe el HTML de esta manera:

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Elige tu paleta</title>
<style>
  body { font-family: sans-serif; padding: 32px; background: #f5f5f5; }
  .palettes { display: flex; flex-wrap: wrap; gap: 24px; }
  .palette { border-radius: 12px; overflow: hidden; width: 260px; box-shadow: 0 2px 12px rgba(0,0,0,0.12); }
  .swatch { height: 56px; display: flex; align-items: center; padding: 0 16px; font-size: 13px; font-weight: 500; }
  .label { padding: 14px 16px; background: white; }
  .label h3 { margin: 0 0 4px; font-size: 15px; }
  .label p { margin: 0; font-size: 12px; color: #666; }
</style>
</head>
<body>
<h2>Elige una paleta de colores</h2>
<div class="palettes">
  <!-- Repite este bloque para cada opción de paleta -->
  <div class="palette">
    <div class="swatch" style="background:#1a2e1a; color:#f5f0e8;">Fondo</div>
    <div class="swatch" style="background:#243824; color:#f5f0e8;">Superficie</div>
    <div class="swatch" style="background:#c9a84c; color:#1a2e1a;">Acento</div>
    <div class="swatch" style="background:#f5f0e8; color:#1a2e1a;">Texto</div>
    <div class="label">
      <h3>1. Bosque &amp; Dorado</h3>
      <p>Autoridad orgánica — verde profundo, dorado cálido, crema</p>
    </div>
  </div>
</div>
</body>
</html>

Guárdalo como color_preview.html en el directorio actual, luego ejecuta open color_preview.html. Dile al usuario: "He abierto una vista previa de colores en tu navegador — échale un vistazo y dime qué número de paleta te gusta."

Después de que elija, elimina color_preview.html y continúa.

Ronda 3 — Tipografía (adaptada a las Rondas 1 y 2)

Ahora genera opciones tipográficas que sean coherentes con la elección de tema y paleta del usuario. No sugieras serifas académicas para un sitio de desarrollador oscuro con acento neón, ni sugerir monoespaciadas para un sitio editorial de moda clara.

Muestra 2-3 combinaciones de fuentes que se adapten al estilo y a la profesión del usuario. Preséntalas de manera que el usuario pueda entender por qué funcionan, sin usar jerga técnica. Usa descripciones como:

  • Opción 1: Contraste Clásico — "Un titular serifa audaz y dramático combinado con un cuerpo sans-serif limpio. Se siente editorial y refinado, como una revista de diseño."
  • Opción 2: Precisión Moderna — "Una fuente monoespaciada para los titulares que se siente técnica y precisa, combinada con una serifa cálida para el cuerpo. Se siente como un cruce entre un cuaderno de desarrollador y una publicación académica."
  • **Opción 3: ** (genera según la profesión)

No muestres una vista previa de fuentes en el navegador (la mayoría de los usuarios no tienen las fuentes instaladas). En su lugar, confía en las descripciones y tu recomendación.

Después de que elijan, confirma la combinación de fuentes elegida.

Ronda 4 — Toques finales (adaptados a todo lo anterior)

Debes decidir una estructura de página que funcione para el contenido de su currículum y preguntar qué tan complejo quieren que sea el sitio.

Estructura de página: Basado en su currículum, propón una estructura de página que tenga sentido. Por ejemplo, para un desarrollador senior: Hero → stack tecnológico → experiencia → proyectos → educación → contacto. Para un diseñador: Hero → filosofía de diseño → trabajo destacado → colaboraciones → contacto. Explica por qué esta estructura funciona para su contenido.

Nivel de detalle: Pregunta si quieren 1) una sola página con scroll con todo, 2) múltiples secciones dentro de una sola página con navegación, o 3) un sitio multipágina con páginas separadas para cada sección.

Pregunta final: "¿Hay algo más que quieras que sepa o algún elemento específico que quieras incluir?"

Paso 5: Escribir el Código del Sitio Web

Una vez que tengas todas las preferencias, escribe el sitio web completo en un único archivo HTML con CSS y JavaScript en línea. El sitio debe ser completamente autónomo — sin dependencias de paquetes, sin módulos npm, sin marco de trabajo. Todo debe estar contenido en ese único archivo.

Requisitos del sitio:

  1. Totalmente autónomo — un solo archivo HTML, sin dependencias externas excepto:

    • Carga de fuentes desde Google Fonts (máximo 2 familias de fuentes, pesos mínimos)
    • Carga de imágenes desde URLs públicas de su currículum (si aplica)
    • Iconos de Font Awesome (usa la versión gratuita desde CDN) o íconos SVG en línea
  2. Totalmente responsivo — se ve increíble en escritorio, tableta y teléfono. Usa consultas de medios CSS.

  3. Compatible con dispositivos táctiles — elementos hover con respaldo táctil, espaciado adecuado para toques, sin dependencia de hover para funcionalidad crítica.

  4. Optimizado para SEO — etiquetas meta apropiadas, marcado schema.org JSON-LD para la persona, etiquetas OG para compartir en redes sociales.

  5. Accesible — roles ARIA apropiados, navegación por teclado, relaciones de contraste de color que cumplan con WCAG AA, atributos lang.

  6. Rendimiento — las fuentes deben cargarse con font-display: swap, las animaciones deben estar optimizadas (prefiere transform y opacity), sin scripts que bloqueen el renderizado.

  7. Preparado para producción — sangría limpia, CSS organizado con comentarios de sección, sin código muerto, sin console.log, sin advertencias.

No uses:

  • Marco de trabajo CSS (Bootstrap, Tailwind, etc.)
  • Marco de trabajo JS (React, Vue, etc.)
  • Herramienta de construcción o empaquetador
  • Dependencias npm
  • Bases de datos o back-end

Estructura del archivo:

Sección HTMLPropósito
<head>Metaetiquetas, carga de fuentes, CSS, preloads
<body>HTML estructurado semánticamente
<script> al final del bodyJS para interactividad, animaciones, IntersectionObserver

Guía de contenido: Llena el sitio con el contenido real del currículum del usuario. No uses texto de relleno, contenido de muestra o secciones vacías. Cada palabra en el sitio debe ser información real del currículum que extrajiste. Si falta algo (por ejemplo, no hay sección de proyectos en su currículum), no incluyas esa sección.

Manejo de imágenes: Si el currículum incluye un enlace a una foto de perfil o imagen de portafolio, úsalo. Si no, no incluyas ninguna imagen ni uses imágenes de stock. No generes imágenes.

Palabras finales: Después de generar el sitio web, verifica que:

  • No hay errores de sintaxis HTML
  • Las hojas de estilo están completas (los elementos no aparecen sin estilo)
  • Los colores coinciden con lo que acordaste con el usuario
  • Los enlaces están funcionando
  • El diseño responsivo se ve bien (verifica con consultas de medios ajustando el ancho del viewport)
  • Las fuentes se cargan correctamente desde Google Fonts
  • Toda la animación de entrada funciona en la carga de la página

Luego informa al usuario: "¡Tu sitio web está listo! Echémosle un vistazo juntos. He incluido toda la información de tu currículum. Si quieres cambiar algo, házmelo saber."

Skills relacionados