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
- Análisis de Código - Analizar estructura de repositorios de GitHub, pila tecnológica, patrones arquitectónicos
- Adaptación a la Audiencia - Generar contenido para ejecutivos, arquitectos y equipos técnicos
- Visualización de Arquitectura - Crear diagramas de sistema, flujo de datos y despliegue
- Cuantificación de Impacto - Extraer y presentar métricas de negocio y logros técnicos
- 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
-
Preguntar por la fuente del proyecto:
- URL/ruta del repositorio de GitHub
- Documentación existente
- Notas del proyecto
-
Entender el contexto:
- ¿Qué problema resolvió?
- ¿Para quién era?
- ¿Cuál fue su rol?
- ¿Qué lo hizo desafiante?
- ¿Cuáles fueron los resultados?
-
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:
- Proporcione acceso a GitHub si es posible (fuente de información más rica)
- Comparta el "por qué" detrás del proyecto (el contexto empresarial importa)
- Incluya cualquier métrica que haya rastreado (incluso informales)
- Mencione los desafíos que superó (estos crean grandes historias)
- Especifique su público objetivo (la profundidad técnica varía mucho)
- 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