Communitygithub.com

RiverAi7z/virtus

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

¿Qué es virtus?

Virtus es una skill especializada para agentes de IA (como Claude Code, Cursor, Codex) que transforma un currículum en PDF en un sitio web personal, portafolio o landing page profesional con un diseño visual único y de alta calidad. Su principal objetivo es evitar la convergencia estética típica de los sitios generados por IA, logrando que cada página se sienta genuinamente diseñada para la persona, su profesión y su personalidad. La skill guía al agente a través de un flujo de trabajo completo: primero extrae el contenido del PDF usando un script con `uv` (o como alternativa el MCP `pdf-reader`), luego analiza la profesión del usuario para determinar una dirección estética adecuada (tipografía, paleta de colores, animación, fondos), y finalmente interactúa con el usuario para ajustar preferencias de diseño mediante preguntas adaptativas y previsualizaciones en vivo. Virtus incluye un mandato detallado de diseño con tipografías distintivas de Google Fonts, paletas de color no clichés, técnicas de animación sutiles y fondos con textura, todo para garantizar un resultado profesional y memorable. Las plataformas compatibles son aquellas donde se pueda ejecutar el script de extracción y el agente tenga acceso a herramientas de archivo y navegador.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/RiverAi7z/virtus/tree/HEAD/skills/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 grado de producción a partir de un CV en PDF. El sitio 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, interioriza esto: el mayor modo de fallo en 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 hacer 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 (sobreutilizadas hasta ser invisibles): Inter, Roboto, Arial, Helvetica, system-ui, -apple-system, Space Grotesk, Poppins. Son valores predeterminados, no elecciones.

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

Editoriales / Serif Expresivas:

  • Cormorant Garamond — romántico, literario, lujo editorial de moda
  • Playfair Display — editorial impreso clásico, trazos de alto contraste
  • Fraunces — serif óptica peculiar, personalidad sorprendente
  • Instrument Serif — refinado y contemporáneo, confianza tranquila
  • DM Serif Display — serif moderno con fuerza
  • Abril Fatface — ultra alto contraste, titulares impactantes
  • Yeseva One — calidez art déco, autoridad accesible
  • Cinzel — gravedad clásica romana

Sans-Serif Limpios pero Distintivos:

  • Syne — geométrico, con visión de diseño, contemporáneo
  • Unbounded — audaz, perfecto para cuadrícula, nativo web
  • Plus Jakarta Sans — cálido y moderno, distinto de Inter
  • Outfit — geométrico fresco con personalidad
  • DM Sans — limpio pero no estéril
  • Josefin Sans — minimalismo geométrico elegante

Para Cuerpo de Texto (legible, distintivo):

  • Lora — serif cálido, literario, legible en longitud
  • Source Serif 4 — confianza editorial
  • Spectral — serif digital elegante
  • Literata — diseñado con precisión para lectura

Para Estética Técnica / Desarrollador:

  • JetBrains Mono — credibilidad de desarrollador
  • IBM Plex Mono — corporativo-técnico, estructurado
  • Space Mono — retro-digital, con carácter
  • Fira Code — ligaduras, estética hacker

Para Estéticas Expresivas / De Nicho:

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

Principio de emparejamiento: Elige una fuente de visualización/titular y una fuente para el cuerpo. Deben contrastar — un titular serif dramático con un cuerpo sans limpio, o un titular monospace preciso con un cuerpo serif 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 ven amateur. Un color dominante + un acento fuerte + neutros cuidadosos es casi siempre más fuerte que tres colores igualmente ponderados.

Combinaciones de colores prohibidas (clichés, esperadas):

  • Degradados morados/violetas sobre blanco (la "estética AI" por defecto)
  • Verde azulado + coral sobre blanco (paleta de startups sobreutilizada)
  • Modo oscuro genérico: fondo #1a1a1a + texto blanco + acento azul
  • Pasteles planos sin contraste o tensión

Arquetipos de paleta distintivos 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 — filo técnico
  • Pizarra #2c3e50 + coral intenso #ff6b4a + crema — modernismo cálido
  • Blanco roto #fafaf8 + tinta #1a1a2e + terracota #c4602a — calidez fundamentada
  • 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 el oscuro porque "se ve 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 — aplicar 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 predeterminado y anima a opacity: 1 — limpio, componible
  • Los estados hover deben usar transition: all 0.2s ease — lo suficientemente rápido para sentirse receptivo
  • Revelaciones activadas por scroll: usa IntersectionObserver + un cambio de clase CSS para las secciones que entran en el viewport
  • Para bordes, subrayados y resaltes: width animada o transformaciones de clip-path se sienten precisas e intencionales

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

Fondos

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

Técnicas:

/* Degradado de malla — múltiples degradados radiales superpuestos */
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 diagonal rayado */
background: repeating-linear-gradient(
  -45deg,
  transparent,
  transparent 8px,
  rgba(201,168,76,0.05) 8px,
  rgba(201,168,76,0.05) 9px
);

Combina la técnica de fondo con la estética general — un sitio de desarrollador con estética terminal podría usar un efecto de línea de barrido sutil; 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 primero el script, recurre al MCP solo si falla.

Opción A: Script 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-currículum.pdf>

Si uv no está instalado, instruye al usuario para 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 pdf-reader (respaldo)

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

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

Después de instalar, 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 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 a portafolio)
  • Título profesional / titular
  • 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. Combina el diseño con su identidad profesional — pero ve más allá de la categorización superficial. Un "ingeniero de software" en un fondo de cobertura tiene estéticas diferentes a uno en una agencia de diseño.

Categoría ProfesionalDirección EstéticaPunto de Partida de FuentesDirección de Color
Ingeniero de Software / DesarrolladorInspirado en terminal, preciso, preferentemente oscuroJetBrains Mono o IBM Plex Mono + sans limpioFondo oscuro + acento eléctrico (cian, verde, ámbar)
Diseñador / Director CreativoAudaz, experimental, fuerte presencia tipográficaSerif expresiva de visualización + sans geométricaAlto contraste, combinaciones inesperadas
Científico de Datos / AnalistaEstructurado, analítico, inspirado en visualización de datosSans preciso + cuerpo serif legibleAzul marino/pizarra profundo + acento único y nítido
Marketing / NegociosSensación de revista editorial, confianza, impulsado por CTASerif titular de alto contraste + sans cálidoDominante cálido + acento audaz
Académico / InvestigadorAcadémico, con mucho serif, 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 serif eleganteOscuro + dorado/champán o azul marino profundo + plateado
Artista / FotógrafoComo 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, centrado en métricasInstrument Serif + sans limpioTono medio confiable + acento nítido
Profesor / EducadorCálido, accesible, legibleFraunces o DM Serif + cuerpo sans cálidoPaleta cálida, brillo más alto
LegalAutoritario, tradicional, estructuradoCinzel o Playfair Display + cuerpo serifAzul marino oscuro o carbón + dorado
Freelancer / 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 en función de lo que el currículum específico revela sobre su personalidad, antigüedad y contexto de la industria.

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

Usa la herramienta AskUserQuestion para recopilar 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 respondió. 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 quieren claro u oscuro, sugerirás las fuentes incorrectas.

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

Pregunta sobre el ambiente general y la dirección claro/oscuro juntos, ya que estos son los dos ejes de los que todo lo demás se ramifica. 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 mejor recomendación y explica por qué les queda bien específicamente. 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í hay 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 de 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 3-4 opciones de paleta. Cada paleta debe tener: colores de fondo, superficie, acento y texto. Escribe el HTML así:

<!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 elijan, elimina color_preview.html y continúa.

Skills relacionados