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
| Tipo | Audiencia | Enfoque |
|---|---|---|
| Diseñador | Clientes, gerentes de contratación | Trabajo visual, casos de estudio, proceso |
| Desarrollador | Reclutadores, clientes, colaboradores | Proyectos, stack técnico, GitHub |
| Creativo (fotógrafo/ilustrador/etc.) | Clientes, galerías | Imágenes a sangre, texto mínimo |
| Freelancer | Clientes potenciales | Servicios, trabajo anterior, contacto/CTA |
| Estudiante / Cambio de carrera | Reclutadores, gerentes de contratación | Proyectos, 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
| Pregunta | Por 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
| Arquetipo | Secciones Clave | Prioridad Visual |
|---|---|---|
| Diseñador | Héroe + Trabajo Seleccionado (casos de estudio) + Sobre Mí + Habilidades + Contacto | Detalle de caso de estudio, tomas de proceso |
| Desarrollador | Héroe + Proyectos (enlaces en vivo + GitHub) + Habilidades/Stack + Sobre Mí + Contacto | Fragmentos de código, demos en vivo, estadísticas de GitHub |
| Creativo | Héroe a sangre + Galería/Cuadrícula + Sobre Mí + Contacto | Las imágenes dominan, UI mínima |
| Freelancer | Héroe + Servicios + Trabajo + Testimonios + Contacto | Prominencia del CTA, señales de confianza |
| Estudiante | Héroe + Proyectos + Habilidades + Sobre Mí + Contacto | Arco 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 gris | Una paleta que exprese personalidad |
| "Hola, soy [Nombre]. Soy diseñador." héroe | Una línea de apertura que genere intriga |
| Cuadrícula de tarjetas de 3 columnas con relleno idéntico | Un diseño que refleje el carácter del trabajo |
| Hover: opacidad 0.8 | Hover: 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:
| Persona | Dirección de Paleta |
|---|---|
| Diseñador minimalista | Casi blanco + 1 acento fuerte, mucho espacio en blanco |
| Creativo audaz | Fondo oscuro + acento vibrante, alto contraste |
| Desarrollador técnico | Estética oscura/terminal O limpio y claro con acentos inspirados en código |
| Freelancer cálido | Tonos tierra, accesible, sensación humana |
| Lujo/premium | Neutros 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órmula | Ejemplo |
|---|---|
| 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:
- Quién eres — estado actual (rol, ubicación, en qué te estás enfocando)
- Cómo llegaste aquí — breve arco (no un currículum, una historia)
- Lo que te importa — el "por qué" detrás del trabajo
- 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">×</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
- Ve a vercel.com/new
- Arrastra la carpeta
portfolio/ - Vercel detecta automáticamente HTML estático
- Haz clic en Deploy
- Copia el enlace del proyecto
- (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".
