Primeiro, mantenha esta skill atualizada — confirme com o usuário antes de executar:
npx hyperframes skills update slideshow. Um no-op rápido quando tudo está atualizado; caso contrário, atualiza esta skill e as skills de domínio principais das quais ela depende antes de você usá-las.
fonte figma: Se o conteúdo ou storyboard do deck vier de uma URL figma.com, execute
/figmaprimeiro — exportação de assets, tokens de marca e reconstrução do storyboard se a fonte for uma tira de quadros de cena — e então construa a partir da sua saída. Não dirija o Figma diretamente por meio de ferramentas MCP brutas: isso ignora a sanitização SVG, a proveniência.media/manifest.jsonle a vinculaçãovar()do token de marca, de modo que uma alteração de marca posterior não pode ser propagada sem uma reimportação completa.
Contrato de criação de apresentação de slides
Uma apresentação de slides HyperFrames é uma composição HyperFrames normal — cenas, clipes, linhas do tempo GSAP — com um ingrediente extra: uma ilha JSON que declara quais cenas são slides e como elas se conectam. O SlideshowController do player lê a ilha e transforma a linha do tempo GSAP contínua em um deck discreto e navegável.
Leia /hyperframes-core primeiro para o contrato de composição base (clipes, faixas, atributos data-*, regras de determinismo). Esta skill cobre apenas o que é novo: o esquema da ilha, regras de escrita de slides, fragmentos, ramificações, validação e o componente de encapsulamento.
Saída — um deck navegável, não um MP4 linear
A saída de uma apresentação de slides é o deck em execução: sirva-o com hyperframes present <project-dir> (ou modo apresentação do Studio) — o SlideshowController do player lê a ilha e gerencia navegação, fragmentos, ramificações e modo apresentador. Veja Apresentação e entrega abaixo.
Não execute hyperframes render em uma apresentação de slides para gerar um único MP4. Um deck é criado como várias composições de cena de alto nível (um data-composition-id por slide) sem uma composição raiz mestra os encapsulando, então render resolve apenas a primeira composição e emite um MP4 silenciosamente truncado (por exemplo, 6 segundos de um deck de 40 segundos). Uma exportação linear da linha principal (apenas slides principais, sequências de ramificação excluídas) é adiada — até que seja lançada, as saídas suportadas são o deck present ao vivo e imagens estáticas snapshot por slide. Se um usuário precisar de um MP4 linear hoje, exponha essa limitação em vez de apontar render para o deck.
Confirmação de intenção
Se o usuário pedir explicitamente por uma apresentação de slides, slide show ou apresentação de slides HyperFrames, prossiga com esta skill. Quando a solicitação chegou por meio de /hyperframes, a triagem da camada de intenção é responsável por esta confirmação — roteado aqui significa já confirmado, então não pergunte novamente; as perguntas de forma de execução da camada não se aplicam (a entrega é um deck, não um vídeo renderizado). Um BRIEF.md, quando presente, carrega a intenção confirmada — leia-o.
Se a skill foi acionada a partir de uma solicitação adjacente como "apresentação", "pitch deck", "deck", "deck interativo" ou "converter esta página", pause antes de criar e apresente a escolha antes de pedir confirmação. Explique brevemente que uma apresentação de slides HyperFrames significa um deck executável com slides discretos, navegação integrada e modo apresentador, notas de orador editáveis, tratamento de mídia compartilhada e validação antes da entrega. Para conversões de página de origem, mencione também que o objetivo é preservar o design visual, as interações, a animação e o comportamento de mídia da página original, enquanto traduz o movimento da página em transições de slide para slide.
Em seguida, faça uma curta pergunta de confirmação:
Você quer isso como uma apresentação de slides HyperFrames?
Use uma interface de escolha sim/não quando o ambiente fornecer uma; caso contrário, faça a pergunta em texto simples.
Não implemente a apresentação de slides até que o usuário diga sim. Se ele disser não, pare de usar esta skill — leia /hyperframes e deixe a camada de intenção redirecionar. Esta confirmação é uma decisão de roteamento, não uma barreira de preferência — conforme ../hyperframes/references/brief-contract.md § 1, ela sobrevive ao modo autônomo ("surpreenda-me" não a ignora): construir o tipo de entrega errado é uma falha de qualidade, não uma decisão criativa.
As duas partes
1. Cenas — declaradas da maneira normal
Cada slide é sustentado por uma cena. Declare cenas com data-composition-id, data-start, data-duration e data-label:
<div
data-composition-id="problem"
data-start="0"
data-duration="8"
data-label="O problema"
data-width="1920"
data-height="1080"
>
<!-- clipes vão aqui -->
</div>
Slides de ramificação (acessíveis apenas por um hotspot, excluídos da linha principal) são declarados exatamente da mesma maneira — eles apenas aparecem apenas em uma entrada slideSequences na ilha, não no array slides principal.
2. A ilha JSON — um bloco de script por composição
Adicione exatamente um bloco <script type="application/hyperframes-slideshow+json"> ao HTML da composição. Ele contém todos os metadados da apresentação de slides:
<script type="application/hyperframes-slideshow+json">
{
"slides": [...],
"slideSequences": [...]
}
</script>
A ilha é a fonte única da verdade para a ordem dos slides, notas, pontos de parada de fragmentos, hotspots e sequências de ramificação. Mantenha-a perto do topo do <body>, antes das divs de cena, para que seja fácil de encontrar.
Não esconda o manifesto da apresentação de slides por trás de um bloco <script type="application/json"> alternativo mais código de tempo de execução que cria a ilha. O comando present lê o HTML da composição estaticamente e espera que a ilha real application/hyperframes-slideshow+json já esteja presente.
Esquema
SlideshowManifest (o objeto de ilha de nível superior)
{
"slides": [
/* SlideRef[] — a linha principal, em ordem */
],
"slideSequences": [
/* SlideSequence[] — sequências de ramificação fora da linha */
]
}
SlideRef
{
"sceneId": "problem",
"notes": "Comece pela dor, não pela empresa.",
"fragments": [3.5, 5.2, 7.0],
"hotspots": [
/* SlideHotspot[] */
],
"ttsScript": null,
"ttsAudioUrl": null,
"ttsDurationMs": null
}
| Campo | Obrigatório | Notas |
|---|---|---|
sceneId | sim | Deve corresponder exatamente ao data-composition-id de uma cena (ou fornecer startTime/endTime explícitos). A regra de lint resolve cenas por data-composition-id. |
notes | não | Texto apenas para o apresentador. Nunca mostrado ao público. |
fragments | não | Array de tempos (segundos) dentro do intervalo [início, fim] do slide — veja Fragmentos abaixo. |
hotspots | não | Sobreposições interativas que acionam uma ramificação — veja Ramificações abaixo. |
startTime | não | Opcional. Substitui os limites de tempo da cena correspondente; padrão é o início/fim da cena. |
endTime | não | Opcional. Substitui os limites de tempo da cena correspondente; padrão é o início/fim da cena. |
ttsScript, ttsAudioUrl, ttsDurationMs | não | Reservado. Campos de esquema existem, mas a reprodução de TTS ainda não está conectada. Omita, a menos que esteja pré-populando para uma versão futura. |
SlideHotspot
{
"id": "h1",
"label": "Como calculamos isso?",
"target": "market-deep-dive",
"region": { "x": 60, "y": 10, "w": 35, "h": 20 }
}
| Campo | Obrigatório | Notas |
|---|---|---|
id | sim | Único dentro do slide. |
label | sim | Texto da dica de ferramenta / botão mostrado ao público. |
target | sim | Deve corresponder a um SlideSequence.id em slideSequences. |
region | não | Caixa delimitadora percentual do slide: {x, y, w, h} em 0–100. Omita para renderizar o hotspot como um botão rotulado de slide inteiro. |
SlideSequence
{
"id": "market-deep-dive",
"label": "Metodologia de dimensionamento de mercado",
"slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}
Os slides dentro de uma sequência usam a mesma forma SlideRef da linha principal. Fragmentos e hotspots aninhados são permitidos.
Regras de escrita de slides
Estas são restrições rígidas, não sugestões. Um slide que as violar será substituído imediatamente quando um revisor o vir.
- O título é uma afirmação de frase completa, não um rótulo. Escreva "PMEs gastam 14 horas/semana em agendamento manual", não "Problema de agendamento". A frase deve ser compreensível sozinha se o visual for ignorado.
- Uma ideia + um visual por slide. Se você sentir vontade de adicionar um segundo grupo de marcadores ou um segundo gráfico, divida o slide.
- Comece pela conclusão. O ponto mais forte vem primeiro — no slide e na ordem do deck. Investidores leem da esquerda para a direita, de cima para baixo, e param.
- Apenas dimensionamento de mercado bottom-up. Nunca escreva "TAM de $50B" sem mostrar a conta. Construa a partir da economia unitária: contas × ACV, ou transações × taxa de retenção.
- Tamanho mínimo de fonte equivalente a 30pt. Em 1920×1080, um título tem 72–96px; o corpo do texto tem 48px. Nunca vá abaixo de 40px para qualquer texto que o público precise ler.
- Pesquise no catálogo ao vivo antes de construir manualmente qualquer visual nomeado. Para cada visual, efeito, gráfico, tratamento ou transição que um slide precisar — "scanlines CRT", "glitch", "corrida de gráfico de barras", "varredura cintilante", "janela de terminal" — execute
npx hyperframes catalog --query "<o visual, em português claro>" --jsone leia os principais resultados antes de criar os clipes do slide. A pesquisa não precisa de nada instalado: nenhum projeto, nenhumaddanterior, nenhuma conta. Ela classifica todo o registro hospedado (~400 blocos e componentes) a partir de qualquer diretório.npx hyperframes add <nome>coloca o código fonte do bloco no deck, onde você o personaliza no local. Isso se aplica com força extra ao portar uma página de origem: um bloco real supera a aproximação simplificada que as regras de portabilidade abaixo proíbem.
Portabilidade de páginas de origem
Ao converter uma página existente em uma apresentação de slides, a fidelidade à origem faz parte do contrato. Não substitua widgets específicos da origem por aproximações simplificadas, a menos que o usuário peça explicitamente por um redesenho.
- Preserve o design visual, a linguagem de animação, o comportamento interativo, o comportamento de mídia e as conveniências de apresentação da página original o mais próximo possível do prático. Quando o sistema de apresentação de slides suportar modo apresentador, inclua notas de orador usando o comportamento compartilhado de notas editáveis, em vez de uma implementação específica do deck.
- Porte visuais mecânicos do DOM/CSS/JS da origem com a maior precisão possível: players personalizados, visualizadores de canvas, linhas do tempo, cabeças de reprodução, hastes, círculos em expansão, estados de hover e outros detalhes interativos devem sobreviver à conversão.
- Trate elementos
<video>/<audio>nativos como a fonte da verdade para qualquer cromo de mídia personalizado, visualizador de canvas, forma de onda, grade de batida ou cabeça de reprodução. Conecte os eventos de mídia da origem (play,pause,timeupdate,seeking,seeked,ended,ratechange,volumechange) e derive o estado visual demedia.currentTime; não execute um temporizador separado que pode se desviar da reprodução real. - Cada
<video>ou<audio>copiado comsrcdeve ter atributos de temporização HyperFrames antes do lint:data-startedata-duration, maisdata-has-audio="true"quando o áudio nativo audível deve ser preservado. Use o intervalo de tempo da cena para mídia específica do slide; para vídeos de evidência controlados pelo usuário que podem ser reproduzidos a partir de vários slides focados, use um intervalo de todo o deck. Não deixepreload="none"na mídia; usemetadataouauto. - Resolva tokens de fonte da origem antes da validação. Se preservar fontes personalizadas da origem, adicione regras
@font-facepara arquivos de fonte locais/capturados. Se usar fallbacks do sistema, substitua declarações tokenizadas comofont-family: var(--f-body)por stacks concretas seguras para renderização, comosystem-ui, sans-serifouui-monospace, monospace; não deixevar(...)como o valor da família de fontes. - Audite a origem para movimentação de página atípica, especialmente comportamento orientado por rolagem, roda, toque, estado de hash, redimensionamento ou um loop requestAnimationFrame. Trate viewports fixas com camadas "mundo" traduzidas/escaladas, parallax, painéis fixos, rolagens horizontais, linhas do tempo com scrub de rolagem, encaixe de seção e câmeras com zoom em elemento como comportamento da origem. A rolagem é frequentemente o gatilho de transição da origem, então preserve a transição extraindo suas paradas de progresso, easing e estados de câmera/foco, e então re-hospede esse movimento na navegação da apresentação de slides por meio de posições de linha do tempo, fragmentos ou um hook de player/arnês reutilizável. Wrappers independentes que pulam para pontos de parada de slide ainda precisam de um hook de transição de câmera de navegação explícito; calcular transformações de câmera por slide não é suficiente. Não simule uma transição literal de rolagem de página para baixo dentro do slide; o visualizador deve sentir viagem/zoom de câmera de um ponto focal para outro, não ver uma página da web sendo rolada. Mantenha cada movimento de câmera de slide para slide contínuo: evite paradas de rota intermediárias que invertam a direção x/y ou reduzam o zoom sem...