Communitygithub.com

infinyte/generador-de-vitrina-de-portafolio

Transforma proyectos técnicos en piezas de portafolio atractivas con resúmenes ejecutivos, análisis técnicos profundos, diagramas de arquitectura, métricas de impacto y páginas de GitHub Pages listas para demostración. Analiza repositorios de GitHub y descripciones de proyectos para generar materiales de exhibición adaptados a la audiencia.

¿Qué es generador-de-vitrina-de-portafolio?

Este skill está diseñado para ayudar a desarrolladores e ingenieros de software a convertir sus proyectos técnicos en materiales de portafolio profesionales y convincentes, optimizados para diferentes audiencias como reclutadores, gerentes de contratación, arquitectos y líderes técnicos. Su principal utilidad radica en la capacidad de analizar repositorios de GitHub (estructura, pila tecnológica, patrones arquitectónicos) o descripciones de proyectos proporcionadas por el usuario, y generar automáticamente múltiples formatos de salida: resúmenes ejecutivos de alto impacto, análisis técnicos profundos, diagramas de arquitectura en Mermaid, historias para entrevistas en formato STAR, métricas de impacto cuantificables y páginas web completas con GitHub Pages. Soporta plataformas como GitHub y entornos de desarrollo locales, y su flujo de trabajo se basa en la recopilación de contexto, el análisis del código fuente y la generación de contenido estructurado. Funciona siguiendo pasos claros: primero, recopila información del proyecto (repositorio, notas, contexto empresarial); segundo, analiza el código (si se proporciona un repositorio); tercero, genera el contenido solicitado; cuarto, crea los artefactos (documentos Markdown, HTML para GitHub Pages, diagramas) y finalmente, empaqueta los entregables según las necesidades del usuario (solicitudes de empleo, sitio de portafolio, preparación para entrevistas).

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add infinyte/portfolio-showcase-generator

Preguntar en tu IA favorita

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

Documentación

Generador de Vitrina de Portafolio

Un skill integral para transformar proyectos técnicos en piezas de portafolio profesionales optimizadas para diferentes audiencias (reclutadores, gerentes de contratación, arquitectos, líderes técnicos).

Capacidades Principales

  1. Análisis de Código - Analizar estructura de repositorios de GitHub, pila tecnológica, patrones arquitectónicos
  2. Adaptación a la Audiencia - Generar contenido para ejecutivos, arquitectos y equipos técnicos
  3. Visualización de Arquitectura - Crear diagramas de sistema, flujo de datos y despliegue
  4. Cuantificación de Impacto - Extraer y presentar métricas de negocio y logros técnicos
  5. Salida Multi-Formato - Resúmenes ejecutivos, análisis técnicos profundos, historias para entrevistas, páginas GitHub Pages

Cuándo Usar Este Skill

Use este skill cuando el usuario quiera:

  • Transformar un proyecto técnico en materiales de portafolio
  • Crear casos de estudio convincentes a partir de su trabajo
  • Generar materiales de preparación para entrevistas (historias en formato STAR)
  • Construir una vitrina profesional con GitHub Pages
  • Extraer el impacto empresarial de los logros técnicos
  • Crear resúmenes de proyecto adaptados a la audiencia

Formatos de Entrada

El skill acepta múltiples formatos de entrada:

1. Repositorio de GitHub

  • URL del repositorio o ruta local
  • Analiza: estructura de archivos, patrones de código, pila tecnológica, dependencias, documentación
  • Extrae: patrones arquitectónicos (DDD, microservicios, etc.), frameworks, servicios en la nube

2. Contexto del Proyecto (cualquier combinación)

  • Notas/viñetas en bruto - Capturas rápidas de logros y detalles
  • Especificaciones técnicas - Documentos de arquitectura, documentos de diseño
  • Conversacional - El usuario describe el proyecto de forma natural
  • Documentación existente - Archivos README, wikis, ADR

3. Contexto Empresarial

  • Metas y objetivos del proyecto
  • Problemas resueltos
  • Interesados y usuarios
  • Cronograma y tamaño del equipo
  • Restricciones y desafíos

Generación de Salida

1. Resumen Ejecutivo (Para Gerentes de Contratación/Reclutadores)

Propósito: Visión general rápida y de alto impacto centrada en el valor empresarial y los resultados.

Estructura:

  • Resumen del Proyecto (2-3 oraciones): Qué es, por qué es importante
  • Logros Clave (3-5 viñetas): Impacto empresarial cuantificado
  • Aspectos Técnicos Destacados (breve): Tecnologías/enfoques notables
  • Cronograma y Alcance: Duración, tamaño del equipo, rol
  • Métricas de Impacto: Mejoras de rendimiento, ahorros de costos, métricas de usuario

Tono: Profesional, seguro, centrado en resultados. Minimizar jerga. Liderar con resultados.

Extensión: 150-250 palabras (lectura de 30-60 segundos)

2. Análisis Técnico Profundo (Para Arquitectos/Líderes Técnicos)

Propósito: Demostrar pensamiento arquitectónico, profundidad técnica y criterio de ingeniería.

Estructura:

  • Contexto y Restricciones: Requisitos, limitaciones, sistemas existentes
  • Decisiones Arquitectónicas: Elecciones de diseño clave con su fundamento
  • Implementación Técnica:
    • Arquitectura del sistema
    • Pila tecnológica y por qué
    • Patrones aplicados (DDD, CQRS, event sourcing, etc.)
    • Puntos de integración
  • Desafíos y Soluciones: Problemas técnicos y cómo los resolvió
  • Escala y Rendimiento: Métricas, estrategias de optimización
  • Seguridad y Calidad: Pruebas, observabilidad, medidas de seguridad
  • Compensaciones: En qué optimizó, qué sacrificó, por qué

Tono: Técnico pero accesible. Explicar el razonamiento, no solo las elecciones. Mostrar criterio.

Extensión: 800-1500 palabras (lectura de 4-6 minutos)

3. Diagramas de Arquitectura (Mermaid)

Generar diagramas relevantes según el tipo de proyecto:

Diagrama de Arquitectura del Sistema:

graph TB
    Client[Cliente]
    API[API Gateway]
    Service1[Nombre del Servicio]
    Service2[Nombre del Servicio]
    DB[(Base de Datos)]
    Cache[(Caché)]
    
    Client --> API
    API --> Service1
    API --> Service2
    Service1 --> DB
    Service1 --> Cache

Diagrama de Flujo de Datos:

flowchart LR
    Source[Fuente de Datos] --> Ingestion[Capa de Ingestión]
    Ingestion --> Processing[Procesamiento]
    Processing --> Storage[(Almacenamiento)]
    Storage --> API[Capa API]
    API --> Consumer[Consumidor]

Diagrama de Despliegue:

graph TB
    subgraph Azure
        subgraph VNet
            AppService[App Service]
            Function[Azure Functions]
        end
        DB[(Base de Datos SQL)]
        Storage[(Blob Storage)]
    end
    
    AppService --> DB
    Function --> Storage

Directrices:

  • Usar el tipo de diagrama apropiado para el contenido
  • Mantener los diagramas enfocados (máximo 5-12 nodos)
  • Usar etiquetas claras y descriptivas
  • Incluir leyenda si es necesario para colores/formas
  • Generar múltiples diagramas si el proyecto es complejo

4. Métricas y Análisis de Impacto

Extraer y presentar logros cuantificables:

Métricas Técnicas:

  • Mejoras de rendimiento (tiempo de respuesta, rendimiento, etc.)
  • Logros de escalabilidad (usuarios soportados, transacciones/segundo)
  • Calidad del código (cobertura de pruebas, reducción de defectos)
  • Confiabilidad (tiempo de actividad, MTTR, tasas de error)
  • Mejoras de seguridad (vulnerabilidades abordadas, cumplimiento alcanzado)

Métricas Empresariales:

  • Ahorros de costos (infraestructura, tiempo de desarrollo)
  • Impacto en ingresos (nuevas capacidades, expansión de mercado)
  • Ganancias de eficiencia (automatización, trabajo manual reducido)
  • Satisfacción del usuario (NPS, tasas de adopción)
  • Tiempo de comercialización (velocidad de entrega, frecuencia de lanzamientos)

Formato: Presentar como números concretos con contexto:

  • "Redujo el tiempo de respuesta de la API en un 60% (450ms → 180ms)"
  • "Redujo los costos de nube en $24K/año mediante la optimización de recursos"
  • "Permitió una escala de 10x de 1K → 10K usuarios concurrentes"

5. Preparación para Entrevistas (Formato STAR)

Generar 2-4 historias convincentes en formato STAR:

Estructura:

  • Situación: Contexto, problema, restricciones (2-3 oraciones)
  • Tarea: Su responsabilidad específica (1-2 oraciones)
  • Acción: Lo que hizo, decisiones técnicas, implementación (3-5 oraciones)
  • Resultado: Resultados, métricas, impacto (2-3 oraciones)

Extensión: Cada historia debe durar 90-120 segundos al hablarla

Enfoque: Diferentes historias deben resaltar:

  • Resolución de problemas técnicos
  • Toma de decisiones arquitectónicas
  • Liderazgo/influencia
  • Manejo de restricciones/compensaciones

6. Sitio GitHub Pages

Generar una estructura de sitio estático completa:

Página de Inicio (index.html):

  • Sección hero con nombre del proyecto y eslogan
  • Estadísticas rápidas (pila tecnológica, cronograma, métricas de impacto)
  • Navegación a secciones
  • Captura de pantalla/demo si está disponible

Página de Arquitectura (architecture.html):

  • Resumen del sistema
  • Diagramas de arquitectura (Mermaid incrustado)
  • Detalles de la pila tecnológica
  • Decisiones de diseño

Página de Impacto (impact.html):

  • Resultados empresariales
  • Logros técnicos
  • Visualización de métricas
  • Comparativas antes/después

Página de Demo (demo.html - si aplica):

  • Demo interactiva o recorrido
  • Capturas de pantalla con anotaciones
  • Escenarios de uso
  • Video incrustado si está disponible

Estilo:

  • Diseño limpio y profesional
  • Adaptable a móviles
  • Carga rápida (dependencias mínimas)
  • Accesible (cumplimiento WCAG)
  • Opcional: Usar CSS Primer de GitHub o Tailwind CDN

Flujo de Trabajo

Paso 1: Recopilar Información

  1. Preguntar por la fuente del proyecto:

    • URL/ruta del repositorio de GitHub
    • Documentación existente
    • Notas del proyecto
  2. Entender el contexto:

    • ¿Qué problema resolvió?
    • ¿Para quién era?
    • ¿Cuál fue su rol?
    • ¿Qué lo hizo desafiante?
    • ¿Cuáles fueron los resultados?
  3. Aclarar las salidas:

    • ¿Qué entregables necesitan?
    • ¿Algún requisito específico (extensión, áreas de enfoque)?
    • ¿Detalles del público objetivo?

Paso 2: Analizar (si se proporciona un repositorio de GitHub)

Usar herramientas bash/view para analizar el repositorio:

# Analizar estructura del repositorio
find /ruta/al/repo -type f -name "*.cs" -o -name "*.csproj" | head -20
find /ruta/al/repo -type f -name "*.yml" -o -name "*.yaml"

# Buscar documentos de arquitectura
find /ruta/al/repo -type f -name "*.md" | grep -i "arquitectura\|diseño\|adr"

# Analizar dependencias
cat /ruta/al/repo/*.csproj
cat /ruta/al/repo/package.json
cat /ruta/al/repo/requirements.txt

# Buscar configuración
find /ruta/al/repo -name "appsettings*.json" -o -name "*.config"

Extraer:

  • Pila tecnológica: Lenguajes, frameworks, bases de datos, servicios en la nube
  • Patrones: DDD, microservicios, event-driven, CQRS, etc.
  • Arquitectura: Monolito, microservicios, serverless, etc.
  • Infraestructura: Proveedor de nube, estrategia de despliegue
  • Prácticas de calidad: Pruebas, CI/CD, monitoreo

Paso 3: Generar Contenido

Generar cada tipo de salida solicitado siguiendo las estructuras anteriores.

Principios clave:

  • Primero la audiencia: Igualar profundidad y jerga a la audiencia
  • Basado en evidencia: Fundamentar afirmaciones en código/documentos cuando sea posible
  • Cuantificar: Siempre tratar de incluir números y métricas
  • Orientado a historias: Enfatizar desafíos → soluciones → impacto
  • Honesto: Reconocer restricciones y compensaciones

Paso 4: Crear Artefactos

Para documentos (resúmenes, análisis profundos):

  • Usar formato markdown
  • Incluir secciones claras con encabezados
  • Agregar fragmentos de código donde sea relevante
  • Incrustar diagramas

Para GitHub Pages:

  • Generar archivos HTML completos
  • Incluir CSS en línea o referenciar CDN
  • Asegurar adaptabilidad a móviles
  • Agregar metaetiquetas para SEO

Para diagramas:

  • Usar la herramienta Mermaid Chart para renderizar
  • Proporcionar tanto el código fuente Mermaid como la imagen renderizada
  • Asegurar que los diagramas sean autoexplicativos

Paso 5: Empaquetar Entregables

Organizar las salidas según las necesidades del usuario:

Para solicitudes de empleo:

  • Resumen ejecutivo (listo para copiar/pegar)
  • 2-3 historias STAR
  • Lista de métricas clave

Para sitio de portafolio:

  • Estructura completa de GitHub Pages
  • Todos los activos organizados
  • Instrucciones de despliegue

Para entrevistas:

  • Historias STAR (impresas/PDF)
  • Diagrama de arquitectura (para referencia en pizarra)
  • Hoja de trucos de métricas

Consideraciones Especiales

Proyectos .NET/Azure

  • Destacar: Patrones DDD, principios SOLID, patrones async/await
  • Enfatizar: Zero Trust, cumplimiento InfoSec, patrones empresariales
  • Pila tecnológica: Versión de .NET, servicios de Azure utilizados, patrones de diseño

Proyectos de Machine Learning/Visión por Computadora

  • Enfocar: Planteamiento del problema, justificación de la selección del modelo, métricas de rendimiento
  • Destacar: Enfoque de entrenamiento, pipeline de datos, optimización de inferencia
  • Métricas: Precisión, exactitud, recall, F1, latencia de inferencia

Proyectos de Integración

  • Enfatizar: Diseño de API, manejo de errores, consistencia de datos
  • Destacar: Integraciones de terceros, limitación de tasa, patrones de resiliencia
  • Métricas: Confiabilidad (tiempo de actividad), precisión de datos, rendimiento

Proyectos Empresariales/Gran Escala

  • Contexto: Escala, requisitos de cumplimiento, restricciones heredadas
  • Destacar: Estrategias de migración, compatibilidad hacia atrás, mitigación de riesgos
  • Métricas: Números de escala, rendimiento bajo carga, optimización de costos

Formato de Salida

Al generar múltiples salidas, organizar de la siguiente manera:

# Vitrina de Portafolio: [Nombre del Proyecto]

## Referencia Rápida
- **Pila Tecnológica**: [Lista]
- **Duración**: [Cronograma]
- **Rol**: [Su rol]
- **Impacto**: [1-2 métricas principales]

## Salidas Generadas

### 1. Resumen Ejecutivo
[Contenido]

### 2. Análisis Técnico Profundo
[Contenido]

### 3. Historias STAR
#### Historia 1: [Título]
[Contenido]

#### Historia 2: [Título]
[Contenido]

### 4. Diagramas de Arquitectura
[Diagramas con explicaciones]

### 5. Panel de Métricas
[Métricas formateadas]

### 6. Archivos de GitHub Pages
[Estructura de archivos y contenidos]

Lista de Verificación de Calidad

Antes de entregar, asegurar:

  • Todas las métricas son específicas y cuantificadas
  • Los términos técnicos están explicados o justificados para la audiencia
  • Los diagramas son claros y están correctamente etiquetados
  • Las historias STAR están completas (los 4 elementos)
  • El resumen ejecutivo pasa la prueba de "discurso de ascensor"
  • El análisis técnico profundo demuestra pensamiento arquitectónico
  • Las páginas GitHub Pages son adaptables a móviles y accesibles
  • Sin errores gramaticales ni tipográficos
  • Terminología consistente en todo el documento
  • Los logros se presentan como impacto, no solo como tareas

Ejemplos de Prompts

Simple: "Crea una vitrina de portafolio para mi proyecto DocFlow en GitHub"

Detallado: "Construí un panel de estado de vuelos usando .NET 8, DDD y Azure. Fue la primera aplicación desplegada en nuestro entorno Zero Trust. Necesito un resumen ejecutivo para reclutadores y un análisis técnico profundo para la entrevista, además de diagramas de arquitectura."

Conversacional: "Quiero mostrar mi proyecto de escáner de documentos con IA. Usa visión por computadora para extraer datos de pizarras y se integra con múltiples sistemas. ¿Puedes ayudarme a crear materiales para mi sitio de portafolio?"

Consejos para Usuarios

Para obtener los mejores resultados:

  1. Proporcione acceso a GitHub si es posible (fuente de información más rica)
  2. Comparta el "por qué" detrás del proyecto (el contexto empresarial importa)
  3. Incluya cualquier métrica que haya rastreado (incluso informales)
  4. Mencione los desafíos que superó (estos crean grandes historias)
  5. Especifique su público objetivo (la profundidad técnica varía mucho)
  6. Note lo que le hizo sentir orgulloso o lo que aprendió (los detalles auténticos resuenan)

Errores comunes a evitar:

  • Ser demasiado humilde (el portafolio no es el lugar para la modestia)
  • Enumerar tareas en lugar de logros ("Construí API" vs "Diseñé una API que redujo la latencia en un 40%")
  • Usar jerga sin contexto para audiencias no técnicas
  • Olvidar cuantificar el impacto
  • Hacer que suene como un informe de equipo en lugar de su contribución

Skills relacionados