¿Qué hace Generador de páginas de aterrizaje?
Genera una página de aterrizaje completa y lista para implementar a partir de cualquier repositorio, analizando su documentación y estructura.
Cuándo usar esta habilidad
- Crear una página de aterrizaje para un repositorio de GitHub
- Generar sitios estáticos a partir de documentación existente
- Estandarizar páginas de aterrizaje en múltiples proyectos
- Convertir contenido de README en páginas de marketing / showcase
Qué hace esta habilidad
- Analizar repositorio: Lee README.md, CHANGELOG.md, package.json/VERSION, docs/, assets/
- Extraer contenido: Identifica título, eslogan, características, instalación, capturas de pantalla
- Mapear a secciones: Hero, Características, Instalación, FAQ, Pie de página (+ opcional: Banner de Riesgo, Precios)
- Generar landing: Crea un sitio estático completo (HTML + CSS + JS)
- Salida lista para implementar: Incluye flujo de trabajo de GitHub Actions para GitHub Pages
Cómo usar
Uso básico
/landing-page-generator from ~/ruta/al/repo
Con opciones
/landing-page-generator from ~/ruta/al/repo --risk-banner --pricing-table
Opciones disponibles
| Opción | Descripción | Valor por defecto |
|---|---|---|
--risk-banner | Agregar banner destacado de advertencia / descargo de responsabilidad arriba del pliegue | false |
--pricing-table | Incluir sección de comparación de precios | false |
--screenshots <ruta> | Ruta a la carpeta de capturas de pantalla | ./assets/ |
--theme [dark|light] | Variante de tema de color | dark |
--search | Habilitar búsqueda Cmd+K | true |
--output <ruta> | Directorio de salida | ./[nombre-repo]-landing/ |
Flujo de trabajo
Paso 1: Análisis del repositorio
Leer y analizar estos archivos del repositorio fuente:
README.md → Fuente de contenido principal (título, eslogan, características, instalación)
CHANGELOG.md → Información de versión, cambios recientes
package.json → Número de versión, dependencias, metadatos
VERSION → Fuente de versión alternativa
docs/ → Páginas adicionales de documentación
assets/ → Capturas de pantalla, imágenes
LICENSE → Tipo de licencia para insignia
Paso 2: Mapa de extracción de contenido
| Fuente | Sección objetivo | Método de extracción |
|---|---|---|
| Título/insignias de README | Hero | Primer H1 + líneas de insignias shield.io |
| TL;DR de README | Eslogan de Hero | Primer párrafo o cita después del título |
| Características de README | Cuadrícula de características | Secciones H2/H3 con listas de viñetas |
| Instalación de README | Inicio rápido | Bloques de código con comandos de shell |
| Uso de README | Ejemplos | Bloques de código con ejemplos |
| FAQ de README | FAQ | Patrones details/summary o H3+P |
| CHANGELOG | Novedades | Últimas 1-3 versiones |
| assets/*.png | Capturas de pantalla | Sección de galería |
Paso 3: Generación de secciones
Generar estas secciones en orden:
-
Encabezado (fijo)
- Logo / nombre del proyecto
- Enlaces de navegación: Características, Instalación, FAQ
- Acciones: Búsqueda (Cmd+K), estrella de GitHub, CTA principal
-
Banner de riesgo (si
--risk-banner)- Estilo naranja / advertencia arriba del pliegue
- Texto de descargo claro y visible
- Enlace a la sección de divulgación detallada
-
Sección Hero
- Título del H1 de README
- Eslogan del TL;DR / primer párrafo
- Insignias de estadísticas (versión, licencia, plataforma)
- CTA: "Inicio rápido" (principal), "Ver en GitHub" (secundario)
-
Arquitectura / Descripción general (si hay diagrama en README)
- Diagrama ASCII convertido a bloque estilizado
- O tarjetas de descripción general
-
Cuadrícula de características
- 4-6 tarjetas de características del README
- Patrón: icono + título + descripción
-
Tabla de precios (si
--pricing-table)- Tabla comparativa de planes
- Tabla de multiplicadores / uso si está presente
-
Galería de capturas de pantalla (si existen assets)
- Galería basada en pestañas o carrusel
- Leyendas del texto alternativo
-
Sección de inicio rápido
- Comando de instalación en una línea (bloque de código destacado)
- Pasos de configuración
- Primer ejemplo de uso
-
Divulgación de riesgos (si
--risk-banner)- Sección de descargo completa
- Consideraciones de términos de servicio
- Recomendaciones
-
Sección FAQ
- Generada a partir del FAQ de README o preguntas comunes
- Patrón de detalles plegables
-
Proyectos relacionados (si hay enlaces en README)
- Tarjetas que enlazan a dependencias / repos relacionados
-
Pie de página
- Enlaces rápidos
- Insignia de licencia
- Información de versión
- Enlaces al autor / repositorio
Paso 4: Estructura de salida
[nombre-proyecto]-landing/
├── index.html # Página de aterrizaje principal
├── styles.css # Hoja de estilos completa
├── search.js # Funcionalidad de búsqueda Cmd+K
├── search-data.js # Índice de búsqueda (FAQ, características)
├── favicon.svg # Generado o copiado
├── robots.txt # SEO
├── CLAUDE.md # Instrucciones del proyecto
├── README.md # Documentación del repositorio de la landing
├── assets/ # Capturas de pantalla copiadas
│ └── [copiadas de la fuente]
└── .github/
└── workflows/
└── static.yml # Despliegue en GitHub Pages
Paso 5: Punto de control de validación
Antes de finalizar, verificar:
- Todas las secciones se renderizan correctamente en un navegador
- Los enlaces apuntan a destinos válidos (repositorio de GitHub, docs, comandos de instalación)
- El diseño responsivo funciona en anchos de móvil (375px), tableta (768px) y escritorio (1280px)
- Accesibilidad: enlaces de salto presentes, etiquetas ARIA en elementos interactivos, contraste de color cumple WCAG AA
Stack tecnológico
- Sin paso de compilación: HTML + CSS + JS puro
- Búsqueda: MiniSearch cargado de forma diferida desde CDN con fallback
- Despliegue: GitHub Pages mediante Actions
- Estilizado: Propiedades personalizadas de CSS, responsivo, tema oscuro por defecto
- Accesibilidad: Enlaces de salto, etiquetas ARIA, navegación por teclado
Patrones CSS (de landings establecidas)
Clases de componentes
/* Botones */
.btn, .btn-primary, .btn-secondary, .btn-github-star, .btn-outline
/* Tarjetas */
.feature-card, .comparison-card, .path-card
/* Diseño */
.container, .features-grid, .hero, .section
/* Utilidades */
.visually-hidden, .skip-link
Variables CSS
:root {
--color-bg: #0d1117;
--color-surface: #161b22;
--color-border: #30363d;
--color-text: #c9d1d9;
--color-text-muted: #8b949e;
--color-primary: #58a6ff;
--color-success: #3fb950;
--color-warning: #d29922;
--color-danger: #f85149;
--space-xs: 0.25rem;
--space-sm: 0.5rem;
--space-md: 1rem;
--space-lg: 1.5rem;
--space-xl: 2rem;
--radius: 6px;
}
Ejemplo
Usuario: /landing-page-generator from ~/projects/mi-proyecto --risk-banner --pricing-table
Salida:
Crea ~/projects/mi-proyecto-landing/ con:
- Página de aterrizaje completa que muestra el enrutador multiproveedor
- Banner de riesgo de ToS prominente (naranja, arriba del pliegue)
- Tarjetas de proveedores (Anthropic, Copilot, Ollama)
- Tablas de precios del README
- Galería de capturas de pantalla
- Listo para despliegue en GitHub Pages
Consejos
- Siempre incluye
--risk-bannerpara proyectos con consideraciones legales / de ToS - Las capturas de pantalla mejoran significativamente la calidad de la landing - asegúrate de que assets/ esté poblado
- La habilidad preserva el idioma del README (inglés / francés)
- Revisa el FAQ generado - puede necesitar personalización
- Prueba el diseño responsivo después de la generación
Referencias
Consulta references/landing-pattern.md para documentación detallada del patrón.
Consulta assets/ para plantillas y fragmentos reutilizables.