Communitygithub.com

bg-szy/TOP-SKILLS

Experto en crear portafolios que realmente consiguen empleos y clientes, no solo muestran trabajo, sino que crean experiencias memorables. Cubre portafolios para desarrolladores, diseñadores, creativos y portafolios que convierten visitantes en oportunidades.

¿Qué es TOP-SKILLS?

Este skill convierte a tu agente AI en un diseñador experto de experiencias de portafolio. Su objetivo es ayudarte a construir un portafolio que no solo muestre tu trabajo, sino que realmente genere empleos y clientes. El skill se enfoca en optimizar cada elemento del portafolio para que cause una primera impresión impactante en los 30 segundos que, en promedio, los reclutadores dedican a revisarlo. Cubre la arquitectura del portafolio, el diseño de showcases de proyectos, la creación de estudios de caso interactivos, el branding personal y la optimización de la conversión de visitantes en oportunidades. Además, incluye estrategias para desarrolladores, diseñadores y creativos, con secciones especializadas como el test de los 30 segundos, la fórmula para la sección hero y patrones de navegación. El skill también aborda problemas comunes como portafolios demasiado complejos, falta de adaptación móvil, llamadas a la acción poco claras y la importancia de mantener el portafolio actualizado. Funciona en plataformas como Claude Code, Cursor y Codex, y se integra con otros skills como `scroll-experience` y `3d-web-experience` para añadir interactividad y efectos avanzados.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/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 empleos y clientes, no solo mostrar trabajo, sino crear 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
  • Branding personal
  • Optimización de conversión
  • Codificación creativa
  • Experiencias memorables

Capacidades

  • Arquitectura de portafolio
  • Diseño de showcases de proyectos
  • Estudios de caso interactivos
  • Branding 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 usarlo: 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 socialBueno tener
Blog/EscritosLiderazgo de pensamientoOpcional

Patrones de Navegación

Opción 1: Desplazamiento de una 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 estudio de caso
- Mejor para SEO

Opción 3: Híbrido
- Secciones principales en una página
- Estudios de caso 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]

Showcase de Proyectos

Cómo presentar el trabajo de manera efectiva

Cuándo usarlo: Al construir secciones de proyectos

Showcase 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 Estudio de Caso

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

Mostrando Impacto

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

Presentación Visual

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

Específicos para Portafolio de Desarrollador

¿Qué funciona para portafolios de desarrolladores?

Cuándo usarlo: 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. Habilidad para 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 de 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

Showcase Técnico

// Muestra fragmentos de código que demuestren:
- Decisiones de arquitectura limpias
- Optimizaciones de rendimiento
- Soluciones ingeniosas
- 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ñadiendo elementos interactivos memorables

Cuándo usarlo: Cuando quieras destacar

Interactividad del Portafolio

Niveles de Interactividad

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

Alto Impacto, Bajo Riesgo

  • Cursor personalizado en escritorio
  • Transiciones suaves de página
  • 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 de SO
- 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 empleos
  • El móvil debe funcionar perfectamente
  • No escondas contenido detrás de interacciones
  • Ten una opción "saltar" para intros 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:

  • Llevas meses "trabajando en el portafolio"
  • 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 lanzarlo

Por qué falla: 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:

Ajustando el Tamaño de tu Portafolio

El Portafolio MVP

ElementoVersión MVP
HeroNombre + título + una línea
Proyectos3-4 mejores piezas
Acerca de2-3 párrafos
ContactoCorreo + 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
  • 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 mostrados
  • El formulario de contacto funciona
  • Carga en menos de 3 segundos
  • Lánzalo.

El portafolio se ve genial en escritorio, pero se rompe en móvil

Severidad: ALTA

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

Síntomas:

  • Se ve bien en las 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 probado en dispositivos reales. Las interacciones complejas no se traducen. Olvidaste las zonas de pulgar.

Solución recomendada:

Portafolio Móvil Primero

Realidad Móvil

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

Imprescindibles para Móvil

  • Legible sin hacer zoom
  • Enlaces táctiles (mín. 44px)
  • La navegación funciona
  • Los 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
  • No hay una solicitud clara

Por qué falla: Sin CTA claro. Contacto enterrado al final. Múltiples acciones en competencia. Asumir que los visitantes lo resolverá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

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 ("Saber más")

El portafolio muestra trabajo antiguo o irrelevante

Severidad: MEDIA

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

Síntomas:

  • Proyectos jQuery en 2024
  • "Hice esto en la universidad"
  • El stack tecnológico no coincide con los trabajos objetivo
  • No has tocado el portafolio en 2+ años

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

Solución recomendada:

Actualización del Portafolio

Cadencia de Actualización

AcciónFrecuencia
Añadir nuevo proyectoAl completarlo
Eliminar proyecto antiguoRevisión anual
Actualizar textoCada 6 meses
Actualizació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 tus objetivos
  • Existe un trabajo mejor

Mostrar Crecimiento

  • Trabajo más reciente primero
  • Fechar proyectos (o no hacerlo)
  • 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: Añadir 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 responsive para móvil.

Acción correctiva: Añadir

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 lazy loading, añadir srcset para imágenes responsive

Proyectos Sin Enlaces en Vivo

Severidad: MEDIA

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

Acción correctiva: Añadir 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: 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 scroll para portafolio)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (Elementos 3D para portafolio)
  • brand|logo|colors|identity -> branding (Branding personal)
  • copy|writing|about me|bio -> copywriting (Texto de portafolio)
  • SEO|search|google -> seo (SEO para 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 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 marca personal
2. Diseñar experiencia única
3. Construir elementos interactivos
4. Mostrar trabajo de forma creativa
5. Asegurar que funcione 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 insinúa: portafolio
  • El usuario menciona o insinúa: sitio web personal
  • El usuario menciona o insinúa: mostrar trabajo
  • El usuario menciona o insinúa: portafolio de desarrollador
  • El usuario menciona o insinúa: portafolio de diseñador
  • El usuario menciona o insinúa: portafolio creativo

Limitaciones

  • Usa este skill solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como sustituto de 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 20 individual skills — each has its own dedicated page.

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

Skills relacionados