Instalação de plugins: Antes de comandos de configuração ou atualização, siga as regras de execução de plugins quando esta skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Primeiro, mantenha esta skill atualizada — confirme com o usuário antes de executar:
npx hyperframes skills update slideshow. Uma operação rápida sem efeito quando tudo está atualizado; caso contrário, atualiza esta skill e as skills de domínio principais das quais ela depende antes de você confiar nelas.
origem 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 origem for uma tira de quadros de cena — depois construa a partir de sua saída. Não acione o Figma diretamente por ferramentas MCP brutas: isso ignora a sanitização de SVG, a proveniência.media/manifest.jsonle a vinculação devar()dos tokens de marca, portanto, uma alteração posterior de marca 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 eles se conectam. O SlideshowController do player lê a ilha e transforma a linha do tempo contínua do GSAP em um deck discreto e navegável.
Leia /hyperframes-core primeiro para o contrato base de composição (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 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 use 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 mestre envolvendo-os, portanto, render resolve apenas a primeira composição e emite um MP4 silenciosamente truncado (por exemplo, 6s de um deck de 40 segundos). Uma exportação linear 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 por slide (snapshot). 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 chegar através de /hyperframes, a triagem da camada de intenção é responsável por essa confirmação — roteado aqui significa já confirmado, portanto, não pergunte novamente; as perguntas de formato 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 for acionada a partir de uma solicitação adjacente como "apresentação", "deck de pitch", "deck", "deck interativo" ou "converta 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 e modo apresentador integrados, notas do palestrante editáveis, manipulação 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 original, interações, movimento e comportamento de mídia da página, traduzindo o movimento da página em transições de slide para slide.
Em seguida, faça uma pergunta curta 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 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 é apoiado 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 via 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 na matriz 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 única fonte da verdade para 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 facilitar a localização.
Não oculte 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 (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 | Observações |
|---|---|---|
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 | Matriz de tempos (segundos) dentro do intervalo [start, end] 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é-povoando para uma compilaçã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 | Observações |
|---|---|---|
id | sim | Único dentro do slide. |
label | sim | Texto de dica / 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 completa, não um rótulo. Escreva "PMEs gastam 14 horas/semana em agendamento manual" não "Problema de agendamento". A frase deve fazer sentido sozinha se o visual for ignorado.
- Uma ideia + um visual por slide. Se você for tentado a adicionar um segundo agrupamento 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 eles param.
- Dimensionamento de mercado ascendente apenas. Nunca escreva "TAM de $50B" sem mostrar a matemática. Construa a partir da economia unitária: contas × ACV, ou transações × taxa de recebimento.
- Tamanho mínimo de fonte equivalente a 30pt. Em 1920×1080, um título tem 72–96px; o corpo do texto tem 48px. Nunca use abaixo de 40px para qualquer texto que o público precise ler.
- Pesquise no catálogo ativo antes de criar qualquer visual nomeado manualmente. Para cada aparência, efeito, gráfico, tratamento ou transição que um slide precisar — "linhas de varredura CRT", "glitch", "corrida de gráfico de barras", "varredura brilhante", "janela de terminal" — execute
npx hyperframes catalog --query "<o visual, em inglês simples>" --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) 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 redesign.
- Preserve o design visual original da página, a linguagem de movimento, o comportamento interativo, o comportamento de mídia e os recursos de apresentação o mais fielmente possível. Quando o sistema de apresentação de slides suportar modo apresentador, inclua notas do palestrante 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 de origem com a maior precisão possível: players personalizados, visualizadores de canvas, linhas do tempo, playheads, 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 playhead. 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 possa se desviar da reprodução real. - Cada
<video>ou<audio>copiado comsrcdeve ter atributos de tempo HyperFrames antes da validação: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 de vários slides focados, use um intervalo de todo o deck. Não deixepreload="none"na mídia; usemetadataouauto. - Resolva tokens de fonte de origem antes da validação. Se preservar fontes de origem personalizadas, adicione regras
@font-facepara arquivos de fonte locais/capturados. Se usar fallbacks de 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 valor da família de fontes. - Audite a origem para movimento atípico de página, especialmente comportamento acionado por rolagem, roda, toque, estado de hash, redimensionamento ou um loop requestAnimationFrame. Trate viewports fixos com camadas de "mundo" traduzidas/escaladas, paralaxe, painéis fixos, rolagens horizontais, linhas do tempo com scrub de rolagem, snapping de seção e câmeras de zoom para elemento como comportamento de origem. A rolagem é frequentemente o gatilho de transição da origem, portanto, preserve a transição extraindo suas paradas de progresso, easing e estados de câmera/foco, depois realoque esse movimento na navegação da apresentação de slides através 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 explícito de transição de câmera de navegação; 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 em...