Communitygithub.com

Landing estática del repositorio

Construye una landing sin build a partir del README, la licencia y los comandos del repositorio, con tema claro y oscuro, Open Graph, JSON-LD y seis idiomas.

¿Qué es Landing estática del repositorio?

make-lp escribe docs/index.html, docs/style.css y docs/main.js solo con archivos que ya están en el repo. La página lleva hero, rejilla de funciones, comandos de instalación y pie, más tokens de tema, tarjetas sociales, datos estructurados, favicon SVG, botones de copiar y textos en inglés, japonés, chino, español, ruso y alemán. No inventa capacidades que el repo no declara.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/hidao80/agent-skills/tree/HEAD/skills/make-lp

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Landing estática del repositorio?

Genera una página de destino estática (docs/index.html + docs/style.css + docs/main.js) cuyo contenido se extrae del repositorio en el que se coloca. Nunca enumere características, proveedores o comandos que no existan realmente en el repositorio.

Fuente de verdad para el contenido

Antes de escribir cualquier cosa, lea lo siguiente:

  • README.* — descripción general, características, pila tecnológica, comandos de instalación/inicio rápido
  • LICENSE* — nombre de la licencia, versión, URL
  • CHANGELOG.* — resumen del historial de cambios
  • package.json, composer.json, requirements.txt, etc.: nombre, descripción, dependencias (la base para las insignias de la pila tecnológica)
  • AGENTS.md, CLAUDE.md, config.toml, GEMINI.md, etc.: el propósito del proyecto y, si el proyecto los tiene, tablas de proveedores/configuraciones compatibles
  • Un docs/index.html existente (si está presente): a menos que se solicite explícitamente un rediseño, reutilice su estructura de secciones y edite el contenido en el lugar en lugar de reconstruirlo desde cero

Elementos requeridos

  1. Tema claro/oscuro — Sobrescribir las propiedades personalizadas de CSS (--bg, --text, --accent, etc.) con una consulta de medios prefers-color-scheme: dark. No agregue un conmutador de tema JS a menos que se le solicite.

  2. OGP + Tarjeta de Twitter/X — og:title, og:description, og:url, og:image, og:type, og:site_name, twitter:card, twitter:title, twitter:description, twitter:image. Apunte og:image/twitter:image a un recurso que ya exista realmente en el repositorio (por ejemplo, social-preview.png). Si no existe ninguno, genere uno primero con la habilidad make-social-preview.

  3. Esquema JSON-LD — Un bloque <script type="application/ld+json"> (SoftwareApplication para una aplicación/herramienta; de lo contrario, cualquier @type que se ajuste al proyecto). Manténgalo coherente con la descripción de OGP.

  4. Favicon — Haga referencia a un SVG de Twemoji que se adapte al proyecto con <link rel="icon">.

  5. Soporte multilingüe a través de multilanguagejs (CDN, sin paso de compilación):

    <script src="https://unpkg.com/[email protected]/dist/multilanguagejs.umd.cjs"></script>
    

    Envuelva cada elemento que se va a traducir en <template type="language-group">, y dentro de él coloque un elemento secundario por idioma, cada uno con un atributo language="xx" (no lang):

    <h2>
      <template type="language-group">
        <span language="en">Features</span>
        <span language="ja">機能</span>
      </template>
    </h2>
    

    Cada template[type=language-group] debe contener exactamente un elemento por idioma compatible — multilanguagejs toma el primer [language=X] que coincida por plantilla, por lo que los duplicados hacen que el contenido se pierda silenciosamente.

    Inicialícelo en main.js:

    var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" });
    ml.setLanguage(lang); // al cargar y en el evento de cambio del selector <select>
    

    <title> y <meta name="description"> están fuera del alcance de las plantillas [language] (la biblioteca solo actualiza el textContent de los elementos coincidentes, y la traducción de una etiqueta <meta> reside en su atributo content, no en su texto). Proporcione a main.js un pequeño diccionario { title, description } por idioma y actualice estas dos etiquetas manualmente junto con ml.setLanguage().

    Detecte el idioma del visitante desde navigator.language, guarde el idioma seleccionado en localStorage y al cargar, vuelva a aplicarlo antes de recurrir a la detección del navegador.

    Conjunto de idiomas requerido (siempre, independientemente de lo que admita la propia aplicación): Inglés (en), Japonés (ja), Chino (zh), Español (es), Ruso (ru), Alemán (de) — al menos 6 idiomas. Esto aplica incluso si src/locales/*.json o el propio i18n.ts/i18n.js de la aplicación cubre solo algunos de ellos (por ejemplo, incluso para una aplicación solo en/ja, haga la página de destino en 6 idiomas). Si se solicita, puede agregar otros idiomas a estos 6.

  6. Botones de copia al portapapeles — Proporcione a cada comando de instalación/ejecución que se muestre en un bloque <code> un botón de copia con un icono SVG en línea (nunca un emoji), con un estado de confirmación de marca de verificación a través de navigator.clipboard.writeText(). Para un diseño coherente, envuelva el <code> y su botón en un contenedor flexible .code-row.

  7. Responsivo — Prioridad móvil. No provoque desplazamiento horizontal en ventanas gráficas estrechas, excepto dentro de contenedores explícitamente destinados a desplazarse (por ejemplo, una tabla de comparación amplia).

  8. Sin paso de compilación — Haga que la página funcione simplemente abriendo el archivo HTML o sirviendo la carpeta estática tal cual, independientemente del empaquetador (Vite, etc.) que use la propia aplicación. Mantenga main.js como código fuente legible. Cárguelo directamente en la página con <script src="main.js">.

  9. Estructura semántica — Estructure estos semánticamente: héroe (título, texto principal, CTA, comando de ejecución principal), capturas de pantalla (reutilice las URL de activos existentes del repositorio/GitHub si las hay), cuadrícula de características, comandos de inicio rápido/instalación, insignias de pila tecnológica, pie de página.

  10. Reutilizar CSS existente — Reutilice las propiedades personalizadas de CSS y los nombres de clase que ya están en el docs/style.css del repositorio en lugar de crear un sistema de estilo separado y paralelo.

  11. Respetar el sistema de diseño — Respete el sistema de diseño en el entorno de ejecución del agente de IA existente. Al agregar nuevo CSS, reutilice las propiedades personalizadas y los nombres de clase existentes, y siga las convenciones de nomenclatura, el diseño, el diseño y el tono y la manera consistentes con el sistema de diseño del repositorio.

Flujo de trabajo

  1. Lea las fuentes de contenido anteriores.
  2. Si docs/ no existe, créelo.
  3. Si docs/index.html ya existe, edítelo en el lugar — a menos que se solicite explícitamente un rediseño, no lo reemplace por completo; mantenga la estructura de la sección y actualice el contenido.
  4. Estructure las secciones semánticamente: héroe (título, texto principal, CTA, comando de ejecución principal), capturas de pantalla (reutilice las URL de activos existentes del repositorio/GitHub si las hay), cuadrícula de características, tabla de comparación/configuración (si el proyecto tiene múltiples proveedores/modos/backends que valga la pena comparar), comandos de inicio rápido/instalación, insignias de pila tecnológica, pie de página.
  5. Reutilice las propiedades personalizadas de CSS y los nombres de clase que ya están en el docs/style.css del repositorio en lugar de crear un sistema de estilo separado y paralelo.
  6. Actualice docs/main.js.
  7. Verifique antes de terminar: no se utilizan emojis para iconos interactivos (solo SVG); cada template[type=language-group] tiene exactamente un elemento secundario por idioma compatible, sin duplicados ni omisiones; OGP/JSON-LD apuntan a archivos/URL que realmente existen en el repositorio.

Skills relacionados