Communitygithub.com

make-slide

**make-slide** é uma habilidade universal para agentes de codificação de IA que gera apresentações HTML em arquivo único com notas do apresentador. A saída é sempre um arquivo `.html` independente, com todo CSS e JS inline — sem etapa de build, sem framework, sem dependências além de CDNs de fontes.

O que é make-slide?

**make-slide** é uma habilidade universal para agentes de codificação de IA, compatível com ferramentas como Claude Code, Cursor, Codex e Gemini CLI. Ela gera apresentações HTML profissionais em um único arquivo, com todo CSS e JS inline, eliminando a necessidade de frameworks ou etapas de build. A habilidade oferece suporte a três modos de entrada: Tópico Apenas, Conteúdo Fornecido e Roteiro Fornecido, permitindo que o agente adapte a estrutura, o conteúdo e as notas do apresentador. Além disso, inclui uma galeria de temas (como minimal-dark, corporate, neon-terminal), navegação por teclado, suporte a toque, notas do apresentador e exportação para PDF, garantindo apresentações interativas e responsivas sem dependências externas.

Funciona com✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add Kuneosu/make-slide

Perguntar na sua IA favorita

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

Prévia

Do README da skill

make-slide preview

Documentação

make-slide — Habilidade de Apresentação para IA

Visão Geral

make-slide é uma habilidade universal para agentes de codificação de IA que gera apresentações HTML em arquivo único com notas do apresentador. A saída é sempre um arquivo .html independente, com todo CSS e JS inline — sem etapa de build, sem framework, sem dependências além de CDNs de fontes.

Qualquer ferramenta de codificação de IA (Claude Code, Gemini CLI, Codex, Cursor, etc.) pode ler este arquivo e seguir as instruções para gerar apresentações profissionais.

Repositório: github.com/kuneosu/make-slide Galeria de Temas: make-slide.vercel.app


Quando Usar

Ative esta habilidade quando a solicitação do usuário corresponder a algum destes padrões:

  • "Faça uma apresentação sobre..."
  • "Crie slides para..."
  • "Construa uma apresentação de slides..."
  • "Transforme isso em uma apresentação"
  • "Faça uma palestra sobre..."
  • "Crie um pitch deck para..."
  • "Gere slides de apresentação..."
  • Qualquer solicitação envolvendo: apresentação, slides, deck, palestra, keynote, pitch, slideshow

Modos de Entrada

Determine qual modo se aplica com base na entrada do usuário:

Modo A: Apenas Tópico

O usuário fornece um tópico e, opcionalmente, uma duração ou público.

"Faça uma palestra de 15 minutos sobre tendências de IA"
"Crie uma apresentação sobre arquitetura de microsserviços"

→ Você projeta a estrutura, o conteúdo e as notas do apresentador do zero.

Modo B: Conteúdo/Material Fornecido

O usuário fornece material de origem (documentos, anotações, dados, artigos).

"Transforme este documento em uma apresentação"
"Crie slides com base nestas notas de reunião"

→ Você organiza e destila o material em slides + notas do apresentador.

Modo C: Roteiro Fornecido

O usuário fornece um discurso escrito ou roteiro de fala.

"Crie slides para este roteiro de discurso"
"Faça um deck visual que acompanhe esta palestra"

→ Você analisa a estrutura do roteiro e cria slides visuais correspondentes. O roteiro se torna as notas do apresentador.


Fluxo de Trabalho

Siga estas etapas em ordem:

Etapa 1: Analisar Entrada

  • Determine o modo de entrada (A, B ou C)
  • Estime o número apropriado de slides:
    • Palestra de 5 min → 8-12 slides
    • Palestra de 10 min → 12-18 slides
    • Palestra de 15 min → 18-25 slides
    • Palestra de 20 min → 25-30 slides
    • Palestra de 30 min → 30-40 slides
  • Identifique o público-alvo e o tom (técnico, empresarial, casual, acadêmico)
  • Detecte o idioma do usuário a partir da conversa (gere o conteúdo nesse idioma)

Etapa 2: Escolher um Tema

Apresente ao usuário o link da galeria de temas para navegação:

Navegue pelos temas aqui: https://make-slide.vercel.app

Se o usuário não escolher um tema, recomende um com base no contexto:

  • Palestra de tecnologia/desenvolvedor → minimal-dark ou neon-terminal
  • Negócios/corporativo → corporate ou minimal-light
  • Pitch de startup → gradient-pop ou keynote-apple
  • Dados/análise → data-focus
  • Educação/workshop → paper ou playful
  • Design/criativo → magazine
  • Lançamento de produto → keynote-apple
  • Evento casual/equipe → playful

Etapa 3: Verificar Necessidade de Imagens

Pergunte ao usuário:

"Gostaria que eu identificasse pontos de inserção de imagens nos slides? Se sim, os marcarei no esboço e você poderá fornecer as URLs das imagens. Se não, usarei placeholders estilizados."

  • Sim → Marque as posições das imagens no esboço, peça ao usuário as URLs das imagens
  • Não → Use placeholders CSS (emoji, ícones SVG, formas CSS) que combinem com o tema

Etapa 4: Gerar Esboço

Crie um esboço slide por slide com:

  • Número do slide
  • Tipo de slide (da Referência de Tipos de Slide abaixo)
  • Título
  • Pontos principais / resumo do conteúdo
  • Posicionamento de imagem (se aplicável)

Apresente o esboço ao usuário para confirmação. Aguarde aprovação ou modificações antes de prosseguir.

Etapa 5: Obter Referência do Tema

Obtenha os arquivos de referência do tema escolhido no GitHub:

  1. reference.html — A apresentação de exemplo completa com todos os tipos de slide, estilos, navegação e recursos interativos. Este é seu modelo principal.
  2. README.md — Diretrizes de design incluindo paleta de cores, tipografia, regras de espaçamento e filosofia de design.

Use as URLs raw do GitHub listadas na seção Lista de Temas abaixo.

Etapa 6: Gerar HTML

Usando o reference.html como modelo:

  • Replique a estrutura HTML, estilos CSS e funcionalidade JS exatos
  • Substitua o conteúdo de demonstração pelo conteúdo real do usuário
  • Mantenha todos os recursos interativos (navegação, tela cheia, notas do apresentador, etc.)
  • Corresponda à tipografia, cores, espaçamentos e animações do tema
  • Garanta que todos os tipos de slide usados correspondam aos padrões da referência

Etapa 7: Gerar Notas do Apresentador

Adicione notas do apresentador como atributos data-notes em cada <div> de slide:

<div class="slide" data-notes="Bem-vindos a todos. Hoje falarei sobre...">
  • As notas devem ser conversacionais e naturais
  • Inclua dicas de tempo quando útil (ex.: "[PAUSA]", "[2 min]")
  • Não repita apenas o texto do slide — expanda-o
  • Inclua transições entre slides (ex.: "Agora vamos passar para...")

Etapa 8: Gerar Roteiro (Modos A e B apenas)

Para os Modos A e B, também gere um arquivo script.md separado contendo:

  • Roteiro de fala completo organizado por slide
  • Estimativas de tempo por seção
  • Dicas de interação com o público
  • Pontos-chave a enfatizar

Para o Modo C, o usuário já tem um roteiro — pule esta etapa.

Etapa 9: Salvar e Entregar

  • Salve a apresentação como index.html (ou nome de arquivo especificado pelo usuário)
  • Salve o roteiro como script.md (se gerado)
  • Ofereça-se para iniciar um servidor local para visualização:
    # Python
    python -m http.server 8000
    # Node.js
    npx serve .
    

Lista de Temas

#ID do TemaEstiloMelhor ParaHTML de ReferênciaREADME
1minimal-darkFundo escuro limpo, tipografia branca, minimalista modernoConferências de tecnologia, palestras de desenvolvedores, apresentações open sourcereference.htmlREADME.md
2minimal-lightFundo branco brilhante, tipografia precisa, inspirado na AppleApresentações gerais, reuniões corporativas, palestras acadêmicasreference.htmlREADME.md
3corporateAzul marinho e acentos dourados, layout profissional estruturadoApresentações de negócios, reuniões com investidores, relatórios trimestraisreference.htmlREADME.md
4gradient-popGradientes vibrantes roxo-rosa-laranja, cartões glass-morphismPitches de startup, lançamentos de produto, campanhas de marketingreference.htmlREADME.md
5neon-terminalTema escuro estilo terminal, neon verde/ciano, efeitos scanlineConferências de desenvolvedores, hackathons, eventos CTF, palestras de segurançareference.htmlREADME.md
6paperEstética kraft-paper quente, tipografia serifada, acentos terracotaPalestras educacionais, conferências acadêmicas, workshops, pesquisareference.htmlREADME.md
7keynote-appleFundos dramáticos escuros/gradientes, inspirado no Keynote da AppleLançamentos de produto, conferências keynote, briefings executivosreference.htmlREADME.md
8magazineLayout editorial de revista, design assimétrico, tipografia dramáticaApresentações de design, revisões de portfólio, diretrizes de marcareference.htmlREADME.md
9data-focusLayout limpo centrado em dados, estética de dashboard, indicadores de tendênciaAnálise de dados, dashboards de KPI, revisões financeiras, relatórios estatísticosreference.htmlREADME.md
10playfulCantos arredondados, cores pastel, acentos de emoji, animações saltitantesWorkshops de equipe, palestras casuais de tecnologia, retrospectivas, eventos comunitáriosreference.htmlREADME.md

Requisitos HTML

Toda apresentação gerada DEVE incluir todos os recursos a seguir. Estes são inegociáveis.

Estrutura do Arquivo

  • Único arquivo .html independente
  • Todo CSS inline em tags <style>
  • Todo JS inline em tags <script>
  • Nenhum arquivo externo, exceto links de CDN listados abaixo

Dependências de CDN Obrigatórias

<!-- Fonte Pretendard (OBRIGATÓRIA) -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/orioncactus/pretendard/dist/web/static/pretendard.min.css">

<!-- JetBrains Mono para blocos de código -->
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;700&display=swap">

<!-- Prism.js para realce de sintaxe (SOMENTE se houver blocos de código) -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism-tomorrow.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
<!-- Adicione componentes de idioma conforme necessário -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-javascript.min.js"></script>

Navegação por Teclado

  • ← / → Teclas de seta: Slide anterior / Próximo
  • Espaço: Próximo slide
  • F: Alternar tela cheia
  • S: Alternar painel de notas do apresentador
  • Esc: Sair da tela cheia

Contador de Slides

  • Exibir número do slide atual e total: 3 / 25
  • Posição: canto inferior direito ou conforme definido pelo tema

Barra de Progresso

  • Indicador visual de progresso mostrando a posição no deck
  • Atualiza a cada transição de slide

Tela Cheia

  • A tecla F alterna o modo tela cheia
  • Botão de tela cheia nos controles da interface
  • Usa a Fullscreen API (requestFullscreen)

Painel de Notas do Apresentador

  • A tecla S alterna o painel de notas do apresentador
  • O painel exibe:
    • Notas do slide atual (do atributo data-notes)
    • Visualização do próximo slide (quando possível)
  • O painel não deve obstruir a visualização principal do slide

Exportação para PDF

@media print {
  /* Oculta todos os controles da interface */
  .controls, .progress-bar, .slide-counter,
  .fullscreen-btn, .speaker-notes-panel,
  nav, button { display: none !important; }

  /* Cada slide = 1 página, paisagem */
  .slide {
    page-break-after: always;
    width: 100vw;
    height: 100vh;
  }

  @page {
    size: landscape;
    margin: 0;
  }
}

Navegação por Toque/Deslize

  • Deslizar para a esquerda → Próximo slide
  • Deslizar para a direita → Slide anterior
  • Implementar usando listeners de eventos de toque (touchstart, touchend)

Transições de Slide

  • Transição de fade entre slides (transições ou animações CSS)
  • Suave e profissional — sem saltos bruscos

Animações de Elementos Escalonadas

  • Elementos dentro de um slide animam sequencialmente (efeito de escalonamento)
  • Usar animações CSS com animation-delay incremental
  • Acionar animações quando o slide se torna ativo

Proporção de Aspecto

  • Proporção 16:9 para todos os slides
  • Centralizado na tela com letterboxing se necessário

Design Responsivo

  • Escala para se ajustar a vários tamanhos de tela
  • O texto permanece legível em todas as resoluções
  • Os controles se adaptam ao tamanho da tela

Estouro de Conteúdo

  • Aplicar overflow-y: auto nas áreas de conteúdo do slide
  • Evita que o conteúdo seja cortado se um slide tiver mais conteúdo do que o espaço
  • A barra de rolagem deve ser sutil e combinar com o tema

Manipulação de Imagens

Padrão: Placeholders CSS

Quando nenhuma URL de imagem for fornecida, use placeholders estilizados que combinem com o tema:

<!-- Placeholder baseado em emoji -->
<div class="image-placeholder">
  <span class="placeholder-icon">🚀</span>
  <span class="placeholder-label">Captura de Tela do Produto</span>
</div>

<!-- Placeholder de forma CSS -->
<div class="image-placeholder gradient-bg">
  <svg>...</svg>
</div>

Quando o Usuário Fornece URLs

<img src="https://example.com/image.jpg" alt="Descrição" loading="lazy">
  • Sempre inclua texto alt descritivo
  • Use loading="lazy" para imagens abaixo da dobra
  • Estilize as imagens para caber no layout do slide sem estourar

Blocos de Código

Realce de Sintaxe com Prism.js

  • Inclua o CDN do Prism.js apenas quando houver blocos de código na apresentação
  • Se não houver blocos de código, omita todas as tags <link> e <script> do Prism.js

Idiomas Suportados

Inclua componentes de idioma do Prism.js conforme necessário:

  • prism-javascript.min.js — JavaScript
  • prism-typescript.min.js — TypeScript
  • prism-python.min.js — Python
  • prism-markup.min.js — HTML/XML (incluído no core)
  • prism-css.min.js — CSS (incluído no core)
  • prism-bash.min.js — Bash/Shell
  • prism-json.min.js — JSON
  • prism-java.min.js — Java
  • prism-go.min.js — Go
  • prism-rust.min.js — Rust

Marcação de Bloco de Código

<pre><code class="language-javascript">
function hello() {
  console.log("Olá, Mundo!");
}
</code></pre>
  • Use a fonte JetBrains Mono para todos os blocos de código
  • Garanta espaçamento adequado e destaques de sintaxe

Tipos de Slide

Crie apresentações usando uma combinação dos seguintes tipos de slide:

TipoDescriçãoUso
slide-titleSlide de título principalSlide de abertura, título da palestra, apresentador
slide-sectionSlide de seção/separadorTransição entre seções principais
slide-contentSlide de conteúdo padrãoInformação geral, pontos de discussão
slide-bulletsLista com marcadoresTópicos, listas de verificação, itens-chave
slide-imageSlide focado em imagemDemonstração de produto, visualização de dados
slide-codeSlide de códigoDemonstração de código, trecho de sintaxe
slide-quoteSlide de citaçãoDepoimentos, citações marcantes, evidências sociais
slide-compareSlide de comparação lado a ladoAntes/depois, prós/contrás, opções
slide-dataSlide de visualização de dadosGráficos, tabelas, KPIs
slide-timelineSlide de linha do tempoCronologia, marcos, cronogramas de projeto
slide-teamSlide de equipeApresentação de equipe, biografias, contatos
slide-matrixGrade/grade de slidesLogotipos, miniaturas, coleções
slide-endSlide de encerramentoObrigado, perguntas, informações de contato

Melhores Práticas

Conteúdo

  • Limite cada slide a 3-5 pontos principais
  • Use uma ideia por slide
  • Mantenha o texto conciso — os slides são auxílios visuais, não documentos
  • Use o contraste de forma eficaz para legibilidade
  • Mantenha a consistência de tom em toda a apresentação

Design

  • Siga as diretrizes de design do tema escolhido
  • Use fontes de forma consistente (títulos vs. corpo do texto)
  • Mantenha amplo espaço em branco
  • Alinhe os elementos a uma grade
  • Use cores para ênfase, não para decoração

Acessibilidade

  • Garanta contraste de cor suficiente (relação WCAG AA no mínimo)
  • Forneça texto alternativo para todas as imagens
  • Use proporções de fonte legíveis
  • Permita navegação por teclado para todos os recursos

Guia de Referência Rápida

# Estrutura básica de arquivo gerado
index.html         # Apresentação HTML independente
script.md          # Roteiro de fala completo (Modos A e B)
<!-- Atributo de notas do apresentador -->
<div class="slide" data-notes="Notas do apresentador aqui">
<!-- Seção de slide de código -->
<div class="slide slide-code">
  <div class="slide-content">
    <h2>Configuração de API</h2>
    <pre><code class="language-python">
import requests
response = requests.get('https://api.exemplo.com')
print(response.json())
    </code></pre>
  </div>
</div>

Links do Repositório

Habilidades Relacionadas