Generador de página 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 este skill
- 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/escaparate
Qué hace este skill
- 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 riesgos, Precios)
- Generar página de aterrizaje: 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 ~/path/to/repo
Con opciones
/landing-page-generator from ~/path/to/repo --risk-banner --pricing-table
Opciones disponibles
| Opción | Descripción | Valor por defecto |
|---|---|---|
--risk-banner | Agregar banner prominente de advertencia/descargo sobre el 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 con Cmd+K | true |
--output <ruta> | Directorio de salida | ./[nombre-repo]-landing/ |
Flujo de trabajo
Paso 1: Análisis del repositorio
Lee y analiza estos archivos del repositorio fuente:
README.md → Fuente principal de contenido (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 alternativa de versión
docs/ → Páginas de documentación adicionales
assets/ → Capturas de pantalla, imágenes
LICENSE → Tipo de licencia para insignia
Paso 2: Mapa de extracción de contenido
| Fuente | Sección destino | Método de extracción |
|---|---|---|
| Título/insignias de README | Hero | Primer H1 + líneas de insignias shield.io |
| TL;DR de README | Eslogan del 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
Genera 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 riesgos (si
--risk-banner)- Estilo naranja/advertencia sobre el 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)
- CTAs: "Inicio rápido" (principal), "Ver en GitHub" (secundario)
-
Arquitectura/Descripción general (si hay diagrama en README)
- Diagrama ASCII convertido a bloque con estilo
- O tarjetas de descripción general
-
Cuadrícula de características
- 4-6 tarjetas de características de las características de README
- Patrón de icono + título + descripción
-
Tabla de precios (si
--pricing-table)- Tabla de comparación 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 de 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/repositorios 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 página de aterrizaje
├── assets/ # Capturas de pantalla copiadas
│ └── [copiado de la fuente]
└── .github/
└── workflows/
└── static.yml # Implementación de GitHub Pages
Paso 5: Punto de control de validación
Antes de finalizar, verifica:
- Todas las secciones se renderizan correctamente en un navegador
- Los enlaces apuntan a destinos válidos (repositorio de GitHub, documentación, 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 que pasa WCAG AA
Stack tecnológico
- Sin paso de compilación: HTML + CSS + JS puro
- Búsqueda: MiniSearch cargado de forma diferida desde CDN con respaldo
- Implementación: GitHub Pages mediante Actions
- Estilo: Propiedades personalizadas de CSS, responsivo, tema oscuro por defecto
- Accesibilidad: Enlaces de salto, etiquetas ARIA, navegación por teclado
Patrones CSS (de páginas de aterrizaje 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/my-project --risk-banner --pricing-table
Salida:
Crea ~/projects/my-project-landing/ con:
- Página de aterrizaje completa que muestra el router multi-proveedor
- Banner prominente de riesgos de Términos de Servicio (naranja, sobre el pliegue)
- Tarjetas de proveedores (Anthropic, Copilot, Ollama)
- Tablas de precios del README
- Galería de capturas de pantalla
- Listo para implementar en GitHub Pages
Consejos
- Incluye siempre
--risk-bannerpara proyectos con consideraciones legales/de Términos de Servicio - Las capturas de pantalla mejoran significativamente la calidad de la página de aterrizaje: asegúrate de que assets/ esté poblado
- El skill conserva 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 la documentación detallada del patrón.
Consulta assets/ para plantillas y fragmentos reutilizables.