Communitygithub.com

Landing estática do repositório

Monta uma landing sem build a partir do README, da licença e dos comandos do repositório, com tema claro e escuro, Open Graph, JSON-LD e seis idiomas.

O que é Landing estática do repositório?

make-lp escreve docs/index.html, docs/style.css e docs/main.js só com arquivos que o repositório já tem. A página traz hero, grade de recursos, comandos de instalação e rodapé, além de tokens de tema, cartões sociais, dados estruturados, favicon SVG, botões de copiar e textos em inglês, japonês, chinês, espanhol, russo e alemão. Não inventa o que o repositório não afirma.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Landing estática do repositório faz?

Gere uma página de destino estática (docs/index.html + docs/style.css + docs/main.js) cujo conteúdo é extraído do repositório onde está inserida. Nunca liste recursos, provedores ou comandos que não existam de fato no repositório.

Fonte da Verdade para o Conteúdo

Antes de escrever qualquer coisa, leia o seguinte:

  • README.* — visão geral, recursos, stack tecnológico, comandos de instalação/início rápido
  • LICENSE* — nome da licença, versão, URL
  • CHANGELOG.* — resumo do histórico de alterações
  • package.json, composer.json, requirements.txt, etc.: nome, descrição, dependências (base para badges de stack tecnológico)
  • AGENTS.md, CLAUDE.md, config.toml, GEMINI.md, etc.: o propósito do projeto e, se o projeto tiver, tabelas de provedores/configurações suportadas
  • Um docs/index.html existente (se presente): a menos que seja explicitamente solicitado um redesign, reutilize sua estrutura de seções e edite o conteúdo no lugar, em vez de reconstruir do zero

Elementos Obrigatórios

  1. Tema claro/escuro — Sobrescreva as propriedades personalizadas CSS (--bg, --text, --accent, etc.) com uma media query prefers-color-scheme: dark. Não adicione um alternador de tema JS a menos que seja solicitado.

  2. Cartão OGP + Twitter/X — og:title, og:description, og:url, og:image, og:type, og:site_name, twitter:card, twitter:title, twitter:description, twitter:image. Aponte og:image/twitter:image para um ativo que já exista de fato no repositório (por exemplo, social-preview.png). Se nenhum existir, gere um primeiro com a habilidade make-social-preview.

  3. Esquema JSON-LD — Um bloco <script type="application/ld+json"> (SoftwareApplication para um aplicativo/ferramenta; caso contrário, qualquer @type que se encaixe no projeto). Mantenha-o consistente com a descrição OGP.

  4. Favicon — Faça referência a um SVG Twemoji que se adeque ao projeto com <link rel="icon">.

  5. Suporte multilíngue via multilanguagejs (CDN, sem etapa de build):

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

    Envolva cada elemento a ser traduzido em <template type="language-group"> e, dentro dele, coloque um elemento filho por idioma, cada um com um atributo language="xx" (não lang):

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

    Cada template[type=language-group] deve conter exatamente um elemento por idioma suportado — multilanguagejs pega o primeiro [language=X] correspondente por template, então duplicatas fazem com que o conteúdo seja perdido silenciosamente.

    Inicialize-o em main.js:

    var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" });
    ml.setLanguage(lang); // ao carregar e no evento de mudança do <select> alternador
    

    <title> e <meta name="description"> estão fora do escopo dos modelos [language] (a biblioteca apenas atualiza o textContent dos elementos correspondentes, e a tradução de uma tag <meta> está em seu atributo content, não em seu texto). Dê a main.js um pequeno dicionário { title, description } por idioma e atualize essas duas tags manualmente junto com ml.setLanguage().

    Detecte o idioma do visitante a partir de navigator.language, salve o idioma selecionado em localStorage e, ao carregar, reaplique-o antes de recorrer à detecção do navegador.

    Conjunto de idiomas obrigatório (sempre, independentemente do que o próprio aplicativo suporta): Inglês (en), Japonês (ja), Chinês (zh), Espanhol (es), Russo (ru), Alemão (de) — pelo menos 6 idiomas. Isso se aplica mesmo que src/locales/*.json ou o próprio i18n.ts/i18n.js do aplicativo cubra apenas alguns deles (por exemplo, mesmo para um aplicativo apenas em en/ja, faça a página de destino em 6 idiomas). Se solicitado, você pode adicionar outros idiomas a esses 6.

  6. Botões copiar para a área de transferência — Dê a cada comando de instalação/execução mostrado em um bloco <code> um botão de cópia com um ícone SVG inline (nunca um emoji), com um estado de confirmação de marca de seleção via navigator.clipboard.writeText(). Para layout consistente, envolva o <code> e seu botão em um contêiner flex .code-row.

  7. Responsivo — Mobile-first. Não cause rolagem horizontal em viewports estreitas, exceto dentro de contêineres explicitamente destinados a rolar (por exemplo, uma tabela de comparação larga).

  8. Nenhuma etapa de build — Faça a página funcionar apenas abrindo o arquivo HTML ou servindo a pasta estática como está, independentemente de qual bundler (Vite, etc.) o próprio aplicativo usa. Mantenha main.js como código-fonte legível. Carregue-o diretamente na página com <script src="main.js">.

  9. Estrutura semântica — Estruture estes elementos semanticamente: hero (título, texto principal, CTA, comando de execução principal), capturas de tela (reutilize URLs de ativos existentes do repositório/GitHub, se houver), grade de recursos, comandos de início rápido/instalação, badges de stack tecnológico, rodapé.

  10. Reutilize CSS existente — Reutilize as propriedades personalizadas CSS e nomes de classe já existentes em docs/style.css do repositório, em vez de criar um sistema de estilos paralelo e separado.

  11. Respeite o sistema de design — Respeite o sistema de design no ambiente de tempo de execução do agente de IA existente. Ao adicionar novo CSS, reutilize propriedades personalizadas e nomes de classe existentes e siga as convenções de nomenclatura, design, layout e tom e maneira consistentes com o sistema de design do repositório.

Fluxo de Trabalho

  1. Leia as fontes de conteúdo acima.
  2. Se docs/ não existir, crie-o.
  3. Se docs/index.html já existir, edite-o no lugar — a menos que seja explicitamente solicitado um redesign, não o substitua por completo; mantenha a estrutura de seções e atualize o conteúdo.
  4. Estruture as seções semanticamente: hero (título, texto principal, CTA, comando de execução principal), capturas de tela (reutilize URLs de ativos existentes do repositório/GitHub, se houver), grade de recursos, tabela de comparação/configurações (se o projeto tiver vários provedores/modos/backends que valham a pena comparar), comandos de início rápido/instalação, badges de stack tecnológico, rodapé.
  5. Reutilize as propriedades personalizadas CSS e nomes de classe já existentes em docs/style.css do repositório, em vez de criar um sistema de estilos paralelo e separado.
  6. Atualize docs/main.js.
  7. Verifique antes de finalizar: nenhum emoji é usado para ícones interativos (apenas SVG); cada template[type=language-group] tem exatamente um elemento filho por idioma suportado, sem duplicatas ou omissões; OGP/JSON-LD apontam para arquivos/URLs que realmente existem no repositório.

Habilidades Relacionadas