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-darkouneon-terminal - Negócios/corporativo →
corporateouminimal-light - Pitch de startup →
gradient-popoukeynote-apple - Dados/análise →
data-focus - Educação/workshop →
paperouplayful - 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:
- reference.html — A apresentação de exemplo completa com todos os tipos de slide, estilos, navegação e recursos interativos. Este é seu modelo principal.
- 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 Tema | Estilo | Melhor Para | HTML de Referência | README |
|---|---|---|---|---|---|
| 1 | minimal-dark | Fundo escuro limpo, tipografia branca, minimalista moderno | Conferências de tecnologia, palestras de desenvolvedores, apresentações open source | reference.html | README.md |
| 2 | minimal-light | Fundo branco brilhante, tipografia precisa, inspirado na Apple | Apresentações gerais, reuniões corporativas, palestras acadêmicas | reference.html | README.md |
| 3 | corporate | Azul marinho e acentos dourados, layout profissional estruturado | Apresentações de negócios, reuniões com investidores, relatórios trimestrais | reference.html | README.md |
| 4 | gradient-pop | Gradientes vibrantes roxo-rosa-laranja, cartões glass-morphism | Pitches de startup, lançamentos de produto, campanhas de marketing | reference.html | README.md |
| 5 | neon-terminal | Tema escuro estilo terminal, neon verde/ciano, efeitos scanline | Conferências de desenvolvedores, hackathons, eventos CTF, palestras de segurança | reference.html | README.md |
| 6 | paper | Estética kraft-paper quente, tipografia serifada, acentos terracota | Palestras educacionais, conferências acadêmicas, workshops, pesquisa | reference.html | README.md |
| 7 | keynote-apple | Fundos dramáticos escuros/gradientes, inspirado no Keynote da Apple | Lançamentos de produto, conferências keynote, briefings executivos | reference.html | README.md |
| 8 | magazine | Layout editorial de revista, design assimétrico, tipografia dramática | Apresentações de design, revisões de portfólio, diretrizes de marca | reference.html | README.md |
| 9 | data-focus | Layout limpo centrado em dados, estética de dashboard, indicadores de tendência | Análise de dados, dashboards de KPI, revisões financeiras, relatórios estatísticos | reference.html | README.md |
| 10 | playful | Cantos arredondados, cores pastel, acentos de emoji, animações saltitantes | Workshops de equipe, palestras casuais de tecnologia, retrospectivas, eventos comunitários | reference.html | README.md |
Requisitos HTML
Toda apresentação gerada DEVE incluir todos os recursos a seguir. Estes são inegociáveis.
Estrutura do Arquivo
- Único arquivo
.htmlindependente - 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óximoEspaço: Próximo slideF: Alternar tela cheiaS: Alternar painel de notas do apresentadorEsc: 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
Falterna 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
Salterna 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)
- Notas do slide atual (do atributo
- 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-delayincremental - 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: autonas á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
altdescritivo - 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— JavaScriptprism-typescript.min.js— TypeScriptprism-python.min.js— Pythonprism-markup.min.js— HTML/XML (incluído no core)prism-css.min.js— CSS (incluído no core)prism-bash.min.js— Bash/Shellprism-json.min.js— JSONprism-java.min.js— Javaprism-go.min.js— Goprism-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 Monopara 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:
| Tipo | Descrição | Uso |
|---|---|---|
slide-title | Slide de título principal | Slide de abertura, título da palestra, apresentador |
slide-section | Slide de seção/separador | Transição entre seções principais |
slide-content | Slide de conteúdo padrão | Informação geral, pontos de discussão |
slide-bullets | Lista com marcadores | Tópicos, listas de verificação, itens-chave |
slide-image | Slide focado em imagem | Demonstração de produto, visualização de dados |
slide-code | Slide de código | Demonstração de código, trecho de sintaxe |
slide-quote | Slide de citação | Depoimentos, citações marcantes, evidências sociais |
slide-compare | Slide de comparação lado a lado | Antes/depois, prós/contrás, opções |
slide-data | Slide de visualização de dados | Gráficos, tabelas, KPIs |
slide-timeline | Slide de linha do tempo | Cronologia, marcos, cronogramas de projeto |
slide-team | Slide de equipe | Apresentação de equipe, biografias, contatos |
slide-matrix | Grade/grade de slides | Logotipos, miniaturas, coleções |
slide-end | Slide de encerramento | Obrigado, 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
- Repositório GitHub: github.com/kuneosu/make-slide
- Galeria de Temas: make-slide.vercel.app
- Problemas/Feedback: github.com/kuneosu/make-slide/issues
