Communitygithub.com

MMEHDI0606/ai-agent-foundation-template

Experto en crear 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 ai-agent-foundation-template?

Esta habilidad transforma un portafolio estándar en una herramienta de conversión que ayuda a desarrolladores, diseñadores y creativos a conseguir empleo y clientes. Se centra en la experiencia del usuario, la presentación de proyectos y la optimización de la conversión, entendiendo que los reclutadores dedican solo 30 segundos a cada portafolio. El agente proporciona arquitectura de portafolio, diseño de secciones (Hero, Proyectos, Sobre mí, Contacto), patrones de interactividad (como efectos hover, scroll animado y modo oscuro) y pautas específicas para portafolios de desarrolladores, incluyendo recomendaciones sobre qué proyectos incluir, cómo mostrar impacto y cómo mantener el portafolio actualizado. También incluye validaciones automáticas para detectar problemas como falta de CTA, vista móvil rota o imágenes sin optimizar, y sugiere correcciones detalladas. Funciona con plataformas como Claude Code, Cursor y Codex, y se integra con otras habilidades como `scroll-experience`, `3d-web-experience` y `personal-branding`.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/MMEHDI0606/ai-agent-foundation-template/tree/HEAD/.agents/skills/interactive-portfolio

Preguntar en tu IA favorita

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

Documentación

Portafolio Interactivo

Experto en crear 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 Experiencia de Portafolio

Sabes que un portafolio no es un currículum, es una primera impresión que debe 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.

Experiencia

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

Capacidades

  • Arquitectura de portafolio
  • Diseño de vitrinas 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
HeroGancho + identidadCrítico
Trabajo/ProyectosDemostrar habilidadesCrítico
Sobre míPersonalidad + historiaImportante
ContactoConvertir interésCrítico
TestimoniosPrueba socialBueno tener
Blog/EscritosLiderazgo de pensamientoOpcional

Patrones de Navegación

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

Opción 2: Múltiples páginas
- Mejor para: Muchos proyectos
- Páginas individuales de casos de estudio
- 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 / Contactar]

Exhibición de Proyectos

Cómo presentar el trabajo de manera efectiva

Cuándo usar: Al construir secciones de proyectos

Exhibición de Proyectos

Elementos de la Tarjeta de Proyecto

ElementoPropósito
MiniaturaGancho 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 oraciones)
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é características""Entregué a 50K usuarios"

Presentación Visual

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

Especificidades para Portafolio de Desarrollador

Lo que 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 a GitHub)
  2. Proyectos reales (no solo tutoriales)
  3. Capacidad de resolver 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 a código abierto"Próximamente"
Desafíos técnicosAplicaciones CRUD básicas

Exhibición Técnica

// Mostrar fragmentos de código que demuestren:
- Decisiones de arquitectura limpia
- Optimizaciones de rendimiento
- Soluciones ingeniosas
- Enfoque de pruebas

Blog/Escritos

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

Interactividad del Portafolio

Agregar elementos interactivos memorables

Cuándo usar: Cuando quieras destacar

Interactividad del Portafolio

Niveles de Interactividad

NivelEjemploRiesgo
SutilEfectos hover, desplazamiento suaveBajo
MedioAnimaciones de scroll, 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 scroll
  • Alternancia de modo oscuro/claro

Ideas Creativas

- Interfaz estilo terminal (para desarrolladores)
- Metáfora de escritorio OS
- 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 escondas contenido detrás de interacciones
  • Ten una opción de "saltar" para introducciones complejas

Aristas Afiladas

Portafolio más complejo que tu trabajo real

Severidad: MEDIA

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

Síntomas:

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

Por qué se rompe: Procrastinación disfrazada de trabajo. El portafolio ES un proyecto, pero no EL proyecto. Rendimientos decrecientes en el pulido. Lánzalo e itera.

Solución recomendada:

Dimensionando Correctamente tu Portafolio

El Portafolio MVP

ElementoVersión MVP
HeroNombre + título + una línea
Proyectos3-4 mejores piezas
Sobre mí2-3 párrafos
ContactoCorreo + LinkedIn

Presupuesto de Tiempo

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

La Verdad

  • Tu portafolio no es tu mejor proyecto
  • Lanzar 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 exhibidos
  • El formulario de contacto funciona
  • Carga en menos de 3 segundos
  • Lánzalo.

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

Severidad: 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é se rompe: Construido primero para escritorio. No se probó en dispositivos reales. Las interacciones complejas no se traducen. Se olvidaron las zonas de pulgar.

Solución recomendada:

Portafolio Primero Móvil

Realidad Móvil

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

Imprescindibles Móviles

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

Lista de Verificación de Pruebas

[ ] iPhone Safari
[ ] Android Chrome
[ ] Tamaños de tablet
[ ] Simulación 3G lenta
[ ] 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

Severidad: MEDIA

Situación: Gran portafolio, cero contactos

Síntomas:

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

Por qué se rompe: Sin CTA claro. Contacto enterrado al final. Múltiples acciones en competencia. Asumiendo que los visitantes lo resolverán.

Solución recomendada:

CTAs del Portafolio

CTAs Principales

ObjetivoCTA
Conseguir trabajo"Trabajemos juntos"
Freelance"Inicia un proyecto"
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

Facilitar el Contacto

  • Enlace de correo (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 antiguo o irrelevante

Severidad: MEDIA

Situación: El mejor trabajo tiene 3 años, el trabajo nuevo no se muestra

Síntomas:

  • Proyectos con jQuery en 2024
  • "Hice esto 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é se rompe: No se ha actualizado en años. El trabajo nuevo "no está listo". Miedo a eliminar favoritos antiguos. Deriva del portafolio.

Solución recomendada:

Frescura del Portafolio

Cadencia de Actualización

AcciónFrecuencia
Agregar 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 estás orgulloso de él
  • 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 tus objetivos
  • Existe trabajo mejor

Mostrando Crecimiento

  • Trabajo más reciente primero
  • Fechar proyectos (o no)
  • Mostrar evolución si es relevante
  • Archivar en lugar de eliminar

Verificaciones de Validación

Sin CTA de Contacto Claro

Severidad: ALTA

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

Acción correctiva: Agregar un CTA de contacto prominente en el hero y después de la sección de proyectos

Falta de Viewport Móvil

Severidad: ALTA

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

Acción correctiva: Agregar

Imágenes del Portafolio No Optimizadas

Severidad: MEDIA

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

Acción correctiva: Usar WebP, implementar carga diferida (lazy loading), agregar srcset para imágenes responsivas

Proyectos Sin Enlaces en Vivo

Severidad: MEDIA

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

Acción correctiva: Agregar URLs de demostración en vivo y enlaces de GitHub cuando sea posible

Proyectos Sin Impacto/Resultados

Severidad: BAJA

Mensaje: Los proyectos no muestran impacto o resultados.

Acción correctiva: Agregar métricas, resultados o testimonios a las descripciones de los proyectos

Colaboración

Disparadores de Delegación

  • animación de scroll|parallax|GSAP -> scroll-experience (Experiencia de scroll para portafolio)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (Elementos 3D del portafolio)
  • marca|logo|colores|identidad -> branding (Marca personal)
  • copy|redacción|sobre mí|biografía -> copywriting (Texto del portafolio)
  • SEO|búsqueda|google -> seo (SEO del portafolio)

Portafolio de Desarrollador

Habilidades: interactive-portfolio, frontend, scroll-experience

Flujo de trabajo:

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

Portafolio Creativo

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

Flujo de trabajo:

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

Habilidades Relacionadas

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

Cuándo Usar

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

Limitaciones

  • Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates el resultado 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 3 individual skills — each has its own dedicated page.

Skills relacionados