Communitygithub.com

qike7777/skill-library

Construye un impresionante sitio web de portafolio personal con una identidad visual distintiva. Integra la base de datos de diseño ui-ux-design-pro (67+ estilos, 161 paletas, 57 combinaciones tipográficas) para una estética audaz y memorable. Cubre branding personal, diseño de vitrina de proyectos, HTML/CSS responsivo, efectos interactivos (hover/filtro/lightbox) y despliegue en Vercel. Diseñado para diseñadores, desarrolladores, freelancers y profesionales creativos.

¿Qué es skill-library?

Esta skill te guía a través de un proceso completo de 5 fases para construir un portafolio personal que no solo muestre tu trabajo, sino que también exprese tu personalidad y deje una impresión duradera. Se integra con la base de datos de diseño 'ui-ux-design-pro', que ofrece más de 67 estilos visuales, 161 paletas de colores y 57 pares tipográficos, permitiéndote crear una identidad visual única y memorable. La skill está diseñada para cualquier profesional creativo: diseñadores, desarrolladores, freelancers y estudiantes, y es compatible con plataformas de desarrollo web estático. El proceso comienza con la comprensión de tu identidad y audiencia, pasa por la investigación de diseño y la creación de un brief, la redacción de contenido estratégico (incluyendo el copy del héroe y descripciones de proyectos), la construcción con HTML, CSS y JavaScript vanilla, y finaliza con el despliegue en Vercel. Incluye directrices detalladas sobre estructura HTML, arquitectura CSS con variables, un grid de proyectos con efectos hover y lightbox, y criterios de calidad para cada fase, asegurando que el portafolio resultante sea profesional, responsivo y efectivo para conseguir clientes o empleo.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/qike7777/skill-library/tree/HEAD/skills/3-websites-and-apps/portfolio

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

skill-library preview

Documentación

SKILL.md — Constructor de Portafolios

Construye un portafolio personal que haga que la gente te recuerde. Respaldado por 67+ estilos de UI, 161 paletas de colores, 57 combinaciones tipográficas y patrones específicos para portafolios. Pipeline: entender → identidad de marca → contenido → construir → desplegar.


Resumen

Un portafolio tiene un solo trabajo: hacer que alguien quiera trabajar contigo. Todo — diseño, texto, selección de proyectos, interacciones — sirve a ese objetivo.

Pipeline (5 Fases):

Fase 0 — Entender    →  ¿Quién eres? ¿Qué haces? ¿Quién está viendo esto?
Fase 1 — Diseñar     →  Identidad visual: estilo, paleta, tipografías — la "sensación" de tu trabajo
Fase 2 — Contenido   →  Biografía, descripciones de proyectos, habilidades, contacto
Fase 3 — Construir   →  HTML/CSS + cuadrícula interactiva de proyectos + animaciones
Fase 4 — Entregar    →  Vista previa en vivo → Despliegue en Vercel

Tipos de Portafolio

TipoAudienciaEnfoque
DiseñadorClientes, gerentes de contrataciónTrabajo visual, casos de estudio, proceso
DesarrolladorReclutadores, clientes, colaboradoresProyectos, stack técnico, GitHub
Creativo (fotógrafo/ilustrador/etc.)Clientes, galeríasImágenes a sangre, texto mínimo
FreelancerClientes potencialesServicios, trabajo anterior, contacto/CTA
Estudiante / Cambio de carreraReclutadores, gerentes de contrataciónProyectos, habilidades, arco narrativo

Stack Tecnológico

Por defecto: HTML + CSS + Vanilla JS — igual que una Landing Page. Sin necesidad de framework.

  • Más rápido de construir y desplegar
  • Cero dependencias, máximo control sobre las animaciones
  • Vercel despliega archivos estáticos al instante

Estructura de Archivos

portfolio/
├── index.html          # Página principal (una sola página o navegación por anclas)
├── styles.css          # Tokens de diseño → reset → layout → componentes → secciones → animaciones
├── main.js             # Filtro, lightbox, efectos de scroll, menú móvil
├── assets/
│   ├── images/         # Capturas de pantalla de proyectos, avatar, imagen OG
│   └── fonts/          # Fuentes auto-alojadas (opcional)
└── README.md

Fase 0 — Entender

0.1 Preguntas Clave

PreguntaPor Qué es Importante
¿Qué haces?Diseñador / desarrollador / fotógrafo / freelancer / estudiante / híbrido
¿Quién visitará esto?Reclutadores, clientes, colaboradores, curadores de galerías
¿Cuál es el objetivo #1?Conseguir trabajo / conseguir clientes freelance / entrar en un programa / solo tener presencia
¿Cuántos proyectos mostrar?3–6 es ideal; calidad sobre cantidad
¿Ya tienes una marca?Colores, fuentes, logo existentes — o empezar desde cero
¿Tono?Mínimo, audaz, oscuro, juguetón, editorial, técnico, de lujo
¿Algún portafolio de referencia?Sitios que amas o de los que quieres diferenciarte

0.2 Mapeo de Arquetipos de Portafolio

ArquetipoSecciones ClavePrioridad Visual
DiseñadorHéroe + Trabajo Seleccionado (casos de estudio) + Sobre Mí + Habilidades + ContactoDetalle de caso de estudio, tomas de proceso
DesarrolladorHéroe + Proyectos (enlaces en vivo + GitHub) + Habilidades/Stack + Sobre Mí + ContactoFragmentos de código, demos en vivo, estadísticas de GitHub
CreativoHéroe a sangre + Galería/Cuadrícula + Sobre Mí + ContactoLas imágenes dominan, UI mínima
FreelancerHéroe + Servicios + Trabajo + Testimonios + ContactoProminencia del CTA, señales de confianza
EstudianteHéroe + Proyectos + Habilidades + Sobre Mí + ContactoArco narrativo — crecimiento y potencial

Fase 1 — Investigación de Diseño

1.1 La Base de Datos de Diseño

# Búsqueda de estilo
python3 src/ui-ux-pro-max/scripts/search.py "<consulta>" --domain style --max-results 5

# Paleta de colores
python3 src/ui-ux-pro-max/scripts/search.py "<estado de ánimo/industria>" --domain color --max-results 5

# Tipografía
python3 src/ui-ux-pro-max/scripts/search.py "<estilo/estado de ánimo>" --domain typography --max-results 3

# Patrones específicos de portafolio
python3 src/ui-ux-pro-max/scripts/search.py "portfolio" --domain landing --max-results 5

# Reglas de tipo de producto para sitios personales
python3 src/ui-ux-pro-max/scripts/search.py "portfolio personal site" --domain product

# Sistema de diseño completo
python3 src/ui-ux-pro-max/scripts/search.py "<consulta>" --design-system -p "Portfolio"

# Fragmentos específicos del stack
python3 src/ui-ux-pro-max/scripts/search.py "<consulta>" --stack html

1.2 Principios Estéticos Específicos para Portafolios

Un portafolio ES el trabajo de diseño. Si se ve genérico, el espectador asume que el trabajo es genérico.

❌ Genérico (evitar)✅ Distintivo (apuntar)
Fondo blanco, fuente Inter, texto grisUna paleta que exprese personalidad
"Hola, soy [Nombre]. Soy diseñador." héroeUna línea de apertura que genere intriga
Cuadrícula de tarjetas de 3 columnas con relleno idénticoUn diseño que refleje el carácter del trabajo
Hover: opacidad 0.8Hover: revela información del proyecto con personalidad
Pie de página: "© 2024 Nombre. Todos los derechos reservados."Pie de página que es una extensión de la marca

1.3 Estrategia de Color para Portafolios

A diferencia de las landing pages (acento = CTA), los colores del portafolio expresan personalidad:

PersonaDirección de Paleta
Diseñador minimalistaCasi blanco + 1 acento fuerte, mucho espacio en blanco
Creativo audazFondo oscuro + acento vibrante, alto contraste
Desarrollador técnicoEstética oscura/terminal O limpio y claro con acentos inspirados en código
Freelancer cálidoTonos tierra, accesible, sensación humana
Lujo/premiumNeutros profundos + dorado/champán, tipografía refinada

1.4 Brief de Diseño para Portafolios

## Brief de Diseño del Portafolio: <Nombre>

### Identidad
- **Quién:** <nombre + rol>
- **Arquetipo:** <diseñador / desarrollador / creativo / freelancer / estudiante>
- **Objetivo del portafolio:** <conseguir trabajo / conseguir clientes / solo tener presencia>
- **Espectador objetivo:** <reclutadores / clientes / colaboradores>

### Personalidad (elige 3 adjetivos)
- <ej., preciso, cálido, audaz>

### Dirección de Estilo
- **Estilo principal:** <de la búsqueda — ej., "Editorial Oscuro", "Minimalismo Suave">
- **Estética en una palabra:** <ej., "enfocado", "expresivo", "técnico">
- **Por qué este estilo se ajusta al trabajo:** <una oración>

### Paleta de Colores
- **Fondo:** <hex> — <nombre>
- **Fondo secundario:** <hex> — para tarjetas/paneles
- **Texto principal:** <hex>
- **Texto atenuado:** <hex>
- **Acento:** <hex> — usado con moderación, máximo impacto
- **Borde/divisor:** <hex>

### Tipografía
- **Fuente de títulos:** <nombre> + peso + URL de Google Fonts
- **Fuente del cuerpo:** <nombre> + URL de Google Fonts
- **Nota de estilo de título:** <ej., "tracking apretado, contraste de escala grande">

### Patrón de Diseño
- **Cuadrícula:** <ej., 2 columnas asimétrico, mampostería, fila a sangre>
- **Estilo de tarjeta de proyecto:** <ej., imagen primero con superposición hover, tarjeta de texto mínimo>
- **Transiciones de sección:** <ej., divisores de ancho completo, entrada escalonada, ninguno>

### Interacciones
- **Hover en tarjeta de proyecto:** <ej., escala + superposición con título/etiquetas>
- **Animaciones de scroll:** <ej., aparición escalonada hacia arriba en la cuadrícula de trabajo>
- **Cursor:** <predeterminado / punto personalizado / ninguno>

1.5 Criterios de Calidad

  • Arquetipo identificado, objetivo principal claro
  • Se buscaron 3+ opciones de estilo antes de decidir
  • La paleta expresa personalidad (no solo valores predeterminados "limpios")
  • La combinación tipográfica tiene contraste — una de exhibición, una de cuerpo
  • El patrón de diseño coincide con el tipo de trabajo (fotografía ≠ proyectos de código)
  • El usuario aprobó el Brief de Diseño

Fase 2 — Contenido

2.1 Copy del Héroe

La línea de apertura del héroe es el texto más importante de la página. Debe responder: quién eres, qué haces y por qué importa — con personalidad.

Opciones de fórmula:

FórmulaEjemplo
Rol + diferenciador"Diseñador de producto que obsesiona con los momentos de 0.1 segundos"
Primero el resultado"Hago que el software complejo se sienta simple"
Declaración audaz"El buen diseño es invisible. El gran diseño es inevitable."
Directo/juguetón"Construyo cosas para la web. Actualmente abierto a trabajar."
Nombre + descriptor"Hola, soy Maya — diseño para humanos, no para pantallas"

Evitar:

  • "Soy un diseñador apasionado con 5 años de experiencia"
  • "Bienvenido a mi portafolio"
  • Adjetivos genéricos: creativo, innovador, dedicado, apasionado

2.2 Descripciones de Proyectos

Cada entrada de proyecto necesita:

### <Nombre del Proyecto>
**Rol:** <tu rol — ej., "Diseñador Principal", "Desarrollador en Solitario">
**Tipo:** <ej., "Aplicación Móvil", "Identidad de Marca", "Aplicación Web">
**Etiquetas:** [<etiquetas de tecnología/habilidad>]

**El desafío:** <1-2 oraciones — qué problema necesitaba solución>
**Lo que hice:** <2-3 oraciones — tu contribución y decisiones específicas>
**El resultado:** <1 oración con un resultado si es posible — "Redujo el tiempo de onboarding en un 40%">

[En Vivo →](<url>)  [Caso de Estudio →](<url>)  [GitHub →](<url>)

Reglas:

  • Empieza con el PROBLEMA, no con la tecnología
  • Tu ROL debe ser específico — "diseñador" no es un rol, "diseñé el flujo de onboarding" sí lo es
  • Si tienes métricas, úsalas. Si no, describe el resultado cualitativo
  • Máximo 3–6 proyectos — cura sin piedad

2.3 Sección Sobre Mí

Estructura:

  1. Quién eres — estado actual (rol, ubicación, en qué te estás enfocando)
  2. Cómo llegaste aquí — breve arco (no un currículum, una historia)
  3. Lo que te importa — el "por qué" detrás del trabajo
  4. Lo que estás buscando — abierto a trabajar / tipos específicos de proyectos / colaboraciones

Extensión: 80–150 palabras. No una biografía, no un CV. Una persona.

2.4 Sección de Habilidades / Stack

Para diseñadores:

Diseño: Figma, Prototipado, Sistemas de Diseño, Tipografía, Motion
Investigación: Entrevistas a Usuarios, Pruebas de Usabilidad, Análisis Competitivo

Para desarrolladores:

Frontend: React, TypeScript, Next.js, CSS/Tailwind
Backend: Node.js, PostgreSQL, REST/GraphQL
Herramientas: Git, Docker, Vercel, Figma

Muéstralas como nubes de etiquetas, cuadrículas de iconos o listas agrupadas — nunca solo una lista plana con viñetas.

2.5 Sección de Contacto

Mantenlo extremadamente simple:

  • Correo electrónico (lo más importante — hazlo clicable con mailto:)
  • 2–3 enlaces a redes sociales (GitHub, LinkedIn, Twitter/X, Dribbble — elige lo relevante)
  • Opcional: una línea corta de "actualmente disponible para..."
  • Opcional: un formulario de contacto simple (Formspree)

Sin formularios de contacto con 6 campos. Sin el relleno de "tomemos un café".

2.6 Criterios de Calidad

  • La línea de apertura del héroe tiene personalidad (no es genérica)
  • Cada proyecto comienza con el problema, no con la tecnología
  • Los roles son específicos, no solo títulos de trabajo
  • La sección Sobre Mí parece escrita por una persona
  • 3–6 proyectos, curados por calidad
  • La sección de contacto tiene un enlace mailto como acción principal

Fase 3 — Construir

3.1 Estructura HTML

<!DOCTYPE html>
<html lang="es">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title><Nombre> — <Rol></title>
  <meta name="description" content="<descripción personal de 150 caracteres>">

  <!-- Google Fonts -->
  <link rel="preconnect" href="https://fonts.googleapis.com">
  <link href="https://fonts.googleapis.com/css2?family=<FuenteTitulo>:wght@400;600;700&family=<FuenteCuerpo>:wght@400;500&display=swap" rel="stylesheet">

  <!-- OG Tags -->
  <meta property="og:title" content="<Nombre> — <Rol>">
  <meta property="og:description" content="<descripción>">
  <meta property="og:image" content="<og-image.jpg>">
  <meta name="twitter:card" content="summary_large_image">

  <link rel="stylesheet" href="styles.css">
</head>
<body>
  <nav class="nav" id="nav">...</nav>

  <main>
    <section class="hero" id="home">...</section>
    <section class="work" id="work">...</section>
    <section class="about" id="about">...</section>
    <section class="skills" id="skills">...</section>  <!-- opcional -->
    <section class="contact" id="contact">...</section>
  </main>

  <footer class="footer">...</footer>

  <div class="project-modal" id="modal" aria-hidden="true">...</div>  <!-- lightbox opcional -->

  <script src="main.js"></script>
</body>
</html>

3.2 Arquitectura CSS

/* ── 1. Google Fonts ── */
/* ── 2. CSS Variables ── */
:root {
  /* Colores del Brief de Diseño */
  --color-bg: <hex>;
  --color-bg-secondary: <hex>;
  --color-text: <hex>;
  --color-text-muted: <hex>;
  --color-accent: <hex>;
  --color-border: <hex>;

  /* Tipografía */
  --font-heading: '<FuenteTitulo>', serif;
  --font-body: '<FuenteCuerpo>', sans-serif;

  /* Escala tipográfica */
  --text-hero: clamp(3rem, 8vw, 7rem);
  --text-h2: clamp(1.75rem, 4vw, 2.75rem);
  --text-h3: clamp(1.125rem, 2vw, 1.5rem);
  --text-body: 1.0625rem;
  --text-sm: 0.875rem;

  /* Espaciado */
  --section-padding: clamp(5rem, 12vw, 10rem);
  --container-width: 1200px;
  --gap: 1.5rem;
  --radius: 8px;
  --radius-lg: 16px;

  /* Transiciones */
  --transition: 0.3s ease;
  --transition-slow: 0.6s ease;
}

/* ── 3. Reset + Base ── */
/* ── 4. Layout (.container, .section, .grid-2, .grid-3) ── */
/* ── 5. Nav (fijo, cambio de fondo consciente del scroll) ── */
/* ── 6. Hero ── */
/* ── 7. Work / Project Grid ── */
/* ── 8. Project Card + Hover ── */
/* ── 9. About ── */
/* ── 10. Skills ── */
/* ── 11. Contact ── */
/* ── 12. Footer ── */
/* ── 13. Modal / Lightbox (si se usa) ── */
/* ── 14. Scroll animations ── */
/* ── 15. Responsive ── */

3.3 Cuadrícula de Proyectos

<!-- Sección de trabajo con filtro opcional -->
<section class="work" id="work">
  <div class="container">
    <div class="work__header">
      <h2 class="work__title">Trabajo Seleccionado</h2>
      <!-- Pestañas de filtro opcionales -->
      <div class="work__filters" role="tablist">
        <button class="filter-btn active" data-filter="all">Todos</button>
        <button class="filter-btn" data-filter="design">Diseño</button>
        <button class="filter-btn" data-filter="dev">Desarrollo</button>
      </div>
    </div>

    <div class="work__grid" id="work-grid">
      <!-- Tarjeta de Proyecto -->
      <article class="project-card" data-category="design" data-index="0">
        <div class="project-card__image">
          <img src="assets/images/project-1.jpg" alt="<Nombre del Proyecto> — <breve descripción>" loading="lazy">
          <div class="project-card__overlay">
            <span class="project-card__type"><Tipo></span>
            <h3 class="project-card__title"><Nombre del Proyecto></h3>
            <div class="project-card__tags">
              <span class="tag">Figma</span>
            </div>
          </div>
        </div>
      </article>
      <!-- ... más tarjetas ... -->
    </div>
  </div>
</section>

3.4 Efectos Hover

/* Tarjeta de Proyecto con superposición */
.project-card__image {
  position: relative;
  overflow: hidden;
  border-radius: var(--radius-lg);
}

.project-card__image img {
  width: 100%;
  height: 100%;
  object-fit: cover;
  transition: transform var(--transition);
}

.project-card__overlay {
  position: absolute;
  inset: 0;
  background: linear-gradient(
    to top,
    rgba(0, 0, 0, 0.85) 0%,
    rgba(0, 0, 0, 0.4) 50%,
    transparent 100%
  );
  display: flex;
  flex-direction: column;
  justify-content: flex-end;
  padding: var(--gap);
  opacity: 0;
  transition: opacity var(--transition);
}

.project-card:hover .project-card__overlay {
  opacity: 1;
}

.project-card:hover img {
  transform: scale(1.05);
}

3.5 Lightbox (Opcional)

<!-- Modal para vista expandida del proyecto -->
<div class="modal" id="modal" aria-hidden="true">
  <div class="modal__overlay" tabindex="-1" data-close-modal>
    <div class="modal__content" role="dialog" aria-modal="true">
      <button class="modal__close" aria-label="Cerrar modal">&times;</button>
      <div class="modal__body">
        <!-- Rellenado dinámicamente por JS -->
      </div>
    </div>
  </div>
</div>

3.6 Navegación Responsiva

/* Menú móvil */
.nav__toggle {
  display: none;
  background: none;
  border: none;
  cursor: pointer;
}

@media (max-width: 768px) {
  .nav__toggle {
    display: block;
  }

  .nav__links {
    position: fixed;
    top: 0;
    right: -100%;
    width: 70%;
    height: 100vh;
    background: var(--color-bg);
    flex-direction: column;
    justify-content: center;
    align-items: center;
    transition: right var(--transition);
  }

  .nav__links.active {
    right: 0;
  }
}

3.7 Criterios de Calidad

  • Tokens de diseño establecidos como variables CSS
  • Cuadrícula de proyectos con modo de cuadrícula CSS
  • Efecto hover en tarjetas de proyecto (superposición o información)
  • Animaciones de scroll (aparición, escalonado, o similar)
  • Navegación responsiva (menú móvil si es necesario)
  • Imágenes con carga diferida
  • Etiquetas OG para compartir en redes sociales
  • (Opcional) Lightbox/modal para proyecto expandido
  • (Opcional) Filtro por categoría

Fase 4 — Desplegar

4.1 Preparación para Producción

# Ejecuta esta verificación antes del despliegue:
# 1. Verificar enlaces rotos (manual)
# 2. Verificar metadatos OG
#    curl -s https://tu-sitio.vercel.app | grep -i "og:"
# 3. Probar responsividad (emulador de Chrome DevTools)
# 4. Revisar contraste de color (WCAG AA)
# 5. Verificar carga diferida de imágenes
# 6. Confirmar que todos los enlaces sean relativos y funcionen

4.2 Despliegue en Vercel

  1. Ve a vercel.com/new
  2. Arrastra la carpeta portfolio/
  3. Vercel detecta automáticamente HTML estático
  4. Haz clic en Deploy
  5. Copia el enlace del proyecto
  6. (Opcional) Configura un dominio personalizado en el panel de Vercel

4.3 Post-Despliegue

  • URL de producción funciona en todos los dispositivos (teléfono, tableta, escritorio)
  • Tiempo de carga < 2 segundos (verifica con Lighthouse)
  • Puntuación de Lighthouse: Rendimiento > 90, Accesibilidad > 90, SEO > 90
  • Los enlaces de redes sociales apuntan a los perfiles correctos
  • mailto enlace funciona
  • (Opcional) Conectar dominio personalizado

Referencias de Estilo de Código

Convención de Nomenclatura de Clases: BEM

/* Bloque */
.project-card { }

/* Elemento */
.project-card__image { }
.project-card__title { }

/* Modificador */
.project-card--featured { }
.filter-btn--active { }

Animaciones de Scroll

/* Animación de aparición por defecto */
.reveal {
  opacity: 0;
  transform: translateY(30px);
  transition: opacity 0.6s ease, transform 0.6s ease;
}

.reveal.visible {
  opacity: 1;
  transform: translateY(0);
}

/* Animaciones variantes */
.reveal-left {
  opacity: 0;
  transform: translateX(-30px);
  transition: opacity 0.6s ease, transform 0.6s ease;
}

.reveal-scale {
  opacity: 0;
  transform: scale(0.95);
  transition: opacity 0.6s ease, transform 0.6s ease;
}

Patrón de JavaScript de Filtro

const filters = document.querySelectorAll('.filter-btn');
const items = document.querySelectorAll('.project-card');

filters.forEach(btn => {
  btn.addEventListener('click', () => {
    const filter = btn.dataset.filter;

    // Actualizar botón activo
    filters.forEach(b => b.classList.remove('active'));
    btn.classList.add('active');

    // Filtrar proyectos
    items.forEach(item => {
      if (filter === 'all' || item.dataset.category === filter) {
        item.style.display = 'block';
        // Desencadenar animación de reaparición
      } else {
        item.style.display = 'none';
      }
    });
  });
});

Criterios de Éxito del Portafolio

No está hecho hasta que un extraño lo mira y quiere trabajar contigo.

  • Alguien que no te conoce puede decir qué haces en 3 segundos
  • La personalidad traspasa (no hay tema "genérico de portafolio")
  • Los proyectos son fáciles de escanear, cada uno cuenta una historia
  • La experiencia móvil se siente tan intencional como la de escritorio
  • El CTA de contacto es imposible de pasar por alto

Hecho para creadores que no quieren un portafolio "suficientemente bueno".

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados