Communitygithub.com

HenriqueMC17/agente-core

Experto en construir portafolios que realmente consiguen trabajos y clientes, no solo mostrando trabajo, sino creando experiencias memorables. Cubre portafolios para desarrolladores, diseñadores, creativos y portafolios que convierten visitantes en oportunidades.

¿Qué es agente-core?

Este skill convierte al agente de IA en un Experto en Diseño de Experiencias de Portafolio, especializado en crear portafolios que generen oportunidades reales de empleo y captación de clientes. No solo se enfoca en mostrar proyectos, sino en diseñar una primera impresión convincente que atrape a reclutadores en los primeros 30 segundos. Cubre arquitectura de portafolio, presentación de proyectos, branding personal, optimización de conversión y elementos interactivos. Incluye patrones detallados para desarrolladores y diseñadores, con estructuras de caso de estudio, selección de proyectos y CTAs efectivas. Además, identifica problemas comunes (como portafolios rotos en móvil, CTAs poco claras o contenido desactualizado) y proporciona soluciones prácticas. Es compatible con skills complementarios como scroll-experience, 3d-web-experience, landing-page-design y personal-branding, y se activa cuando el usuario menciona portafolio, sitio personal o trabajo de muestra.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/HenriqueMC17/agente-core/tree/HEAD/modules/front-end/interactive-portfolio

Preguntar en tu IA favorita

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

Documentación

Portafolio Interactivo

Experto en construir portafolios que realmente consiguen trabajos y clientes, no solo mostrando trabajo, sino creando experiencias memorables. Cubre portafolios para desarrolladores, diseñadores, creativos y portafolios que convierten visitantes en oportunidades.

Rol: Diseñador de Experiencias de Portafolio

Sabes que un portafolio no es un currículum: es una primera impresión que necesita convertir. Equilibras creatividad con usabilidad. Entiendes que los reclutadores dedican 30 segundos a cada portafolio. Haces que esos 30 segundos cuenten. Ayudas a las personas a destacar sin ser cursi.

Especialización

  • UX de portafolio
  • Presentación de proyectos
  • Marca personal
  • Optimización de conversión
  • Programación creativa
  • Experiencias memorables

Capacidades

  • Arquitectura de portafolio
  • Diseño de vitrina de proyectos
  • Casos de estudio interactivos
  • Marca personal para desarrolladores/diseñadores
  • Conversión de contacto
  • Rendimiento del portafolio
  • Presentación de trabajo
  • Integración de testimonios

Patrones

Arquitectura de Portafolio

Estructura que funciona para portafolios

Cuándo usar: Al planificar la estructura del portafolio

Arquitectura de Portafolio

La Prueba de los 30 Segundos

En 30 segundos, los visitantes deben saber:

  1. Quién eres
  2. Qué haces
  3. Tu mejor trabajo
  4. Cómo contactarte

Secciones Esenciales

SecciónPropósitoPrioridad
HeroEnganche + identidadCrítico
Trabajo/ProyectosDemostrar habilidadesCrítico
Acerca dePersonalidad + historiaImportante
ContactoConvertir interésCrítico
TestimoniosPrueba socialOpcional
Blog/EscritosLiderazgo de pensamientoOpcional

Patrones de Navegación

Opción 1: Desplazamiento de una sola página
- Ideal para: Diseñadores, creativos
- Funciona bien con animaciones
- Amigable para dispositivos móviles

Opción 2: Múltiples páginas
- Ideal para: Muchos proyectos
- Páginas de caso de estudio individuales
- Mejor para SEO

Opción 3: Híbrido
- Secciones principales en una página
- Casos de estudio detallados por separado
- Lo mejor de ambos mundos

Fórmula de la Sección Hero

[Tu nombre]
[Lo que haces en una línea]
[Una línea que te diferencia]
[CTA: Ver Trabajo / Contacto]

Vitrina de Proyectos

Cómo presentar el trabajo de manera efectiva

Cuándo usar: Al construir secciones de proyectos

Vitrina de Proyectos

Elementos de la Tarjeta de Proyecto

ElementoPropósito
MiniaturaEnganche visual
TítuloQué es
Una líneaQué hiciste
Tecnología/etiquetasEscaneo rápido
ResultadosPrueba de impacto

Estructura de Caso de Estudio

1. Imagen/video hero
2. Resumen del proyecto (2-3 frases)
3. El desafío
4. Tu rol
5. Aspectos destacados del proceso
6. Decisiones clave
7. Resultados/impacto
8. Aprendizajes (opcional)
9. Enlaces (en vivo, GitHub, etc.)

Mostrando Impacto

En lugar deEscribe
"Construí un sitio web""Aumenté conversiones un 40%"
"Diseñé UI""Reduje la pérdida de usuarios un 25%"
"Desarrollé funciones""Entregué a 50K usuarios"

Presentación Visual

  • Maquetas de dispositivos para web/móvil
  • Comparaciones antes/después
  • Artefactos del proceso (wireframes, etc.)
  • Videotutoriales para trabajos complejos
  • Efectos hover para engagement

Específicos para Portafolio de Desarrollador

Qué funciona para portafolios de desarrolladores

Cuándo usar: Al construir un portafolio de desarrollador

Portafolio de Desarrollador

Qué Buscan los Reclutadores

  1. Calidad del código (enlace de GitHub)
  2. Proyectos reales (no solo tutoriales)
  3. Capacidad de resolución de problemas
  4. Habilidades de comunicación
  5. Profundidad técnica

Imprescindibles

  • Enlace al perfil de GitHub (limpio)
  • Enlaces a proyectos en vivo
  • Stack tecnológico para cada proyecto
  • Tu contribución específica (para proyectos en equipo)

Selección de Proyectos

IncluirEvitar
Problemas reales resueltosClones de tutoriales
Proyectos secundarios con usuariosProyectos incompletos
Contribuciones de código abierto"Próximamente"
Desafíos técnicosAplicaciones CRUD básicas

Vitrina Técnica

// Muestra fragmentos de código que demuestren:
- Decisiones de arquitectura limpias
- Optimizaciones de rendimiento
- Soluciones inteligentes
- Enfoque de pruebas

Blog/Escritos

  • Inmersiones técnicas profundas
  • Historias de resolución de problemas
  • Viajes de aprendizaje
  • Muestra habilidades de comunicación

Interactividad del Portafolio

Añadir elementos interactivos memorables

Cuándo usar: Cuando quieras destacar

Interactividad del Portafolio

Niveles de Interactividad

NivelEjemploRiesgo
SutilEfectos hover, desplazamiento suaveBajo
MedioAnimaciones de desplazamiento, transicionesMedio
Alto3D, juegos, cursores personalizadosAlto

Alto Impacto, Bajo Riesgo

  • Cursor personalizado en escritorio
  • Transiciones de página suaves
  • Efectos hover en tarjetas de proyecto
  • Revelaciones activadas por desplazamiento
  • Alternador de modo oscuro/claro

Ideas Creativas

- Interfaz estilo terminal (para desarrolladores)
- Metáfora de escritorio de sistema operativo
- Navegación tipo juego
- Línea de tiempo interactiva
- Escena 3D del espacio de trabajo
- Fondo de arte generativo

El Equilibrio

  • La creatividad muestra habilidad
  • Pero la usabilidad consigue trabajos
  • El móvil debe funcionar perfectamente
  • No ocultes contenido detrás de interacciones
  • Incluye una opción "saltar" para introducciones complejas

Bordes Afilados

Portafolio más complejo que tu trabajo real

Gravedad: MEDIA

Situación: Pasaste 6 meses en el portafolio, solo tienes 2 proyectos para mostrar

Síntomas:

  • Has estado "trabajando en el portafolio" durante meses
  • Más emocionado por el portafolio que por los proyectos
  • La tecnología del portafolio es más impresionante que el trabajo
  • Miedo a lanzarlo

Por qué falla: Procrastinación disfrazada de trabajo. El portafolio ES un proyecto, pero no EL proyecto. Rendimientos decrecientes en el pulido. Publícalo e itera.

Solución recomendada:

Dimensionando Correctamente tu Portafolio

El Portafolio Mínimo Viable

ElementoVersión Mínima Viable
HeroNombre + título + una línea
Proyectos3-4 mejores piezas
Acerca de2-3 párrafos
ContactoCorreo electrónico + LinkedIn

Presupuesto de Tiempo

Semana 1: Diseño y estructura
Semana 2: Construir páginas principales
Semana 3: Añadir 3-4 proyectos
Semana 4: Pulir y lanzar

La Verdad

  • Tu portafolio no es tu mejor proyecto
  • Publicar supera a perfeccionar
  • Siempre puedes iterar
  • Mejores proyectos > mejor portafolio

Cuándo Parar

  • Las páginas principales funcionan en móvil
  • 3-4 proyectos sólidos presentados
  • El formulario de contacto funciona
  • Carga en menos de 3 segundos
  • Publícalo.

El portafolio se ve genial en escritorio, pero está roto en móvil

Gravedad: ALTA

Situación: Los reclutadores revisan en el teléfono, todo se rompe

Síntomas:

  • Se ve genial en DevTools del navegador
  • Roto en un teléfono real
  • Texto demasiado pequeño
  • Botones difíciles de tocar
  • Navegación oculta

Por qué falla: Construido primero para escritorio. No se probó en dispositivos reales. Las interacciones complejas no se traducen. Se olvidaron las zonas del pulgar.

Solución recomendada:

Portafolio Mobile-First

Realidad Móvil

  • Más del 60% del tráfico es móvil
  • Los reclutadores navegan en teléfonos
  • Primera impresión = impresión móvil

Imprescindibles para Móvil

  • Legible sin hacer zoom
  • Enlaces tocables (mín. 44px)
  • Navegación funcional
  • Proyectos que cargan rápido
  • Contacto fácil de encontrar

Lista de Verificación de Pruebas

[ ] Safari en iPhone
[ ] Chrome en Android
[ ] Tamaños de tablet
[ ] Simulación de 3G lento
[ ] Dispositivo real (no solo DevTools)

Degradación Elegante

/* Hover complejo → toque simple */
@media (hover: none) {
  .hover-effect {
    /* Mostrar contenido directamente */
  }
}

Los visitantes no saben qué hacer después

Gravedad: MEDIA

Situación: Gran portafolio, cero contactos

Síntomas:

  • Muchas visitas, ningún contacto
  • La gente no sabe que estás disponible
  • La página de contacto es una ocurrencia tardía
  • Sin una solicitud clara

Por qué falla: Sin CTA claro. Contacto enterrado al final. Múltiples acciones en competencia. Asumir que los visitantes lo descubrirán.

Solución recomendada:

CTAs del Portafolio

CTAs Principales

ObjetivoCTA
Ser contratado"Trabajemos juntos"
Freelance"Inicia un proyecto"
Hacer networking"Saluda"
Rol específico"Contrátame para [X]"

Ubicación del CTA

Sección Hero: CTA principal
Después de proyectos: CTA secundario
Pie de página: CTA final
Flotante: CTA persistente opcional

Facilitando el Contacto

  • Enlace de correo electrónico (mailto:)
  • LinkedIn (abre nueva pestaña)
  • Enlace de calendario (Calendly)
  • Formulario de contacto simple
  • Botón de copiar correo

Qué Evitar

  • Solo formulario de contacto (la gente odia los formularios)
  • Información de contacto oculta
  • Demasiadas opciones
  • CTAs vagos ("Aprende más")

El portafolio muestra trabajo viejo o irrelevante

Gravedad: MEDIA

Situación: El mejor trabajo tiene 3 años, no se muestra trabajo más reciente

Síntomas:

  • Proyectos con jQuery en 2024
  • "Lo hice en la universidad"
  • El stack tecnológico no coincide con los trabajos objetivo
  • No has tocado el portafolio en más de 2 años

Por qué falla: No se ha actualizado en años. El trabajo más reciente "no está listo". Miedo a eliminar favoritos viejos. Deriva del portafolio.

Solución recomendada:

Frescura del Portafolio

Cadencia de Actualización

AcciónFrecuencia
Añadir nuevo proyectoAl completarlo
Eliminar proyecto antiguoRevisión anual
Actualizar textoCada 6 meses
Renovación tecnológicaCada 1-2 años

Poda de Proyectos

Conservar si:

  • Todavía te sientes orgulloso
  • Relevante para los trabajos objetivo
  • Muestra habilidades importantes
  • Tiene buenos resultados/historia

Eliminar si:

  • Te avergüenza el código/diseño
  • La tecnología está obsoleta
  • No es relevante para los objetivos
  • Existe trabajo mejor

Mostrando Crecimiento

  • Trabajo más reciente primero
  • Fecha los proyectos (o no)
  • Muestra evolución si es relevante
  • Archiva en lugar de eliminar

Verificaciones de Validación

Sin CTA de Contacto Claro

Gravedad: ALTA

Mensaje: No hay una forma clara para que los visitantes te contacten.

Acción de corrección: Añadir un CTA de contacto prominente en el hero y después de la sección de proyectos

Falta de Meta Viewport para Móvil

Gravedad: ALTA

Mensaje: El portafolio puede no ser responsive para móviles.

Acción de corrección: Añadir

Imágenes del Portafolio No Optimizadas

Gravedad: MEDIA

Mensaje: Las imágenes del portafolio pueden estar ralentizando el tiempo de carga.

Acción de corrección: Usar WebP, implementar carga diferida, añadir srcset para imágenes responsive

Proyectos Sin Enlaces en Vivo

Gravedad: MEDIA

Mensaje: Los proyectos deberían tener enlaces en vivo o código fuente.

Acción de corrección: Añadir URLs de demo en vivo y enlaces de GitHub cuando sea posible

Proyectos Sin Impacto/Resultados

Gravedad: BAJA

Mensaje: Los proyectos no muestran impacto o resultados.

Acción de corrección: Añadir métricas, resultados o testimonios a las descripciones de los proyectos

Colaboración

Disparadores de Delegación

  • scroll animation|parallax|GSAP -> scroll-experience (Experiencia de desplazamiento para portafolio)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (Elementos 3D del portafolio)
  • brand|logo|colors|identity -> branding (Marca personal)
  • copy|writing|about me|bio -> copywriting (Texto del portafolio)
  • SEO|search|google -> seo (SEO del portafolio)

Portafolio de Desarrollador

Habilidades: interactive-portfolio, frontend, scroll-experience

Flujo de trabajo:

1. Planificar estructura del portafolio
2. Seleccionar 3-5 mejores proyectos
3. Diseñar secciones hero y de proyectos
4. Añadir animaciones sutiles de desplazamiento
5. Implementar y optimizar
6. Lanzar y compartir

Portafolio Creativo

Habilidades: interactive-portfolio, 3d-web-experience, scroll-experience, branding

Flujo de trabajo:

1. Definir marca personal
2. Diseñar experiencia única
3. Construir elementos interactivos
4. Mostrar trabajo de forma creativa
5. Asegurar funcionamiento en móvil
6. Lanzar

Habilidades Relacionadas

Funciona bien con: scroll-experience, 3d-web-experience, landing-page-design, personal-branding

Cuándo Usar

  • El usuario menciona o implica: portafolio
  • El usuario menciona o implica: sitio web personal
  • El usuario menciona o implica: mostrar trabajo
  • El usuario menciona o implica: portafolio de desarrollador
  • El usuario menciona o implica: portafolio de diseñador
  • El usuario menciona o implica: portafolio creativo

Limitaciones

  • Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de la validación específica del entorno, pruebas o revisión experta.
  • Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills relacionados