Communitygithub.com

scroll-narrative

Use quando um site, landing page, página de produto, portfólio ou estudo de caso deve contar uma história em vez de listar blocos — páginas de scrollytelling, storytelling, páginas “narrativas” ou “cinemáticas”, páginas baseadas em capítulos, linhas do tempo, jornadas, antes/depois, ou quando uma página parece um catálogo entediante de seções.

O que é scroll-narrative?

Esta skill capacita agentes de IA a projetar e construir páginas web que contam uma história por meio do scroll, em vez de simplesmente empilhar seções de informações. Ela é ideal para landing pages, portfólios, estudos de caso, sites de marcas, turismo, produtos SaaS e qualquer página que precise de uma experiência narrativa. A skill começa antes do código: o agente deve definir o herói, o desejo, o obstáculo, a virada e o depois, além de escolher um dispositivo narrativo (linha do tempo, caminho, zoom, transformação, contagem regressiva ou personagem). Em seguida, cria-se uma “beat sheet” (folha de batidas) — um roteiro com até 9 batidas que guiam a progressão visual e textual da página. A implementação técnica utiliza os assets `storymotion.css` e `storymotion.js` da skill `web-motion`, que fornecem cenas fixas (pinned), legendas passo a passo, revelações, contadores, indicador de capítulo e gauge de progresso arrastável. A skill enfatiza o ritmo (alternar cenas densas e esparsas), acessibilidade (funcionar sem JS e com movimento reduzido) e responsividade (mobile com pins mais curtos e tipografia maior). O resultado é uma página que prende o visitante do começo ao fim, com cada scroll revelando um novo pedaço da história.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehorSS/storymotion/tree/main/skills/scroll-narrative

Perguntar na sua IA favorita

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

Documentação

Scroll Narrative

Nem todo site precisa de uma história. Decida primeiro: uma narrativa completa (marcas, pequenos negócios, viagens, lugares, artesanato, serviços com resultados visíveis), uma cena narrativa única (SaaS, apps: geralmente "como funciona"), ou nenhuma (lojas, documentações, painéis, formulários: movimento apenas para feedback, use apenas web-motion). Para parcial, aplique esta habilidade apenas àquela cena.

Um site narrativo é uma história que o visitante percorre com a roda de rolagem. Os fatos são tecidos na trama, não empilhados como blocos de recursos. O movimento (veja a skill web-motion) é como o tempo passa nessa história.

1. Encontre a história antes de qualquer código

Responda em uma linha cada:

  • Herói — quem ou o que seguimos (o visitante, o produto, um lugar, um prato, um dia).
  • Desejo — o que eles querem ou para onde vão.
  • Obstáculo — o que está no caminho (o problema que o produto resolve).
  • Virada — o momento em que as coisas mudam (o produto, o cume, a primeira mordida).
  • Depois — o mundo após a virada, e a única ação que o visitante toma agora.

Em seguida, escolha um dispositivo narrativo que estrutura toda a rolagem:

DispositivoRolagem significaBom para
Eixo do tempoamanhecer → noite, 1920 → hoje, dia 1 → dia 30restaurantes, eventos, história, rotinas
Caminhomover-se ao longo de uma rota ou mapaviagens, logística, expedições, imóveis
Zoomcidade → rua → quarto → detalhearquitetura, produtos, artesanato
Transformaçãobruto → finalizado, antes → depoisserviços, reformas, SaaS, fitness
Contagem regressivaem direção a um lançamento ou um momento de picofestivais, lançamentos, drops
Personagemseguir o dia de uma pessoaaplicativos, serviços B2C

2. Escreva a folha de batidas

Salve como beats.md antes de construir. Uma linha por batida:

#BatidaManchete (≤ 8 palavras)Corpo (≤ 40 palavras)Fato entrelaçadoVisualMovimentoComprimento da rolagem

Arco padrão (6–9 batidas):

  1. Gancho — a primeira tela. Em 3 segundos: o que é isso, o número-chave, a ação principal. Nada de "role para descobrir" sem mais nada.
  2. Configuração — o mundo antes; o herói e o desejo.
  3. Jornada (2–4 batidas) — progresso através do dispositivo; cada batida carrega um fato como um ponto da trama ("às 6h o pão já está pronto — 140 pães").
  4. Virada — a maior cena: geralmente um palco fixo (200–300 vh) percorrido pela rolagem.
  5. Prova — números, rostos, avaliações, contados como o resultado da história.
  6. Resolução + CTA — onde a história termina, e uma ação clara. Repita a ação do gancho.

3. Regras de ritmo

  • Uma ideia, um visual, um movimento por batida.
  • Alterne denso e esparso: após uma cena fixa, uma foto calma de página inteira ou uma única frase.
  • No máximo ~3 cenas fixas por página; cada fixação deve merecer seu comprimento de rolagem.
  • Página total: 6–12 alturas de viewport no desktop. Mais longo apenas se cada tela ainda trouxer novidades.
  • O texto aparece com o momento que descreve, nunca antes dele.
  • O visitante sempre sabe onde está: rótulo de capítulo + indicador de progresso.
  • A própria rolagem conta a história: o indicador usa o dispositivo narrativo como sua metáfora (hora, km, escala, ano, número do capítulo) e a paleta e tipografia do site; os capítulos são marcados nele e nomeados ao passar o mouse.

4. Conteúdo e acabamento

  • As fotos são a protagonista: apenas alta resolução, nítidas a 100% de corte; srcset responsivo.
  • Escreva como uma pessoa, palavras simples; sem "desencadear", "elevar", "perfeito".
  • Números são pontos da trama, não uma grade de estatísticas — a menos que a grade seja o clímax.
  • Cada batida deve sobreviver ao movimento reduzido e sem JS: ainda lê como uma boa página longa.
  • Mobile não é um desktop encolhido: pins mais curtos (150–200 vh), palco empilhado, tipo maior.

5. Construção

  1. Construa sobre storymotion.css + storymotion.js (em web-motion/assets/; cenas fixas com --p, legendas passo a passo, revelações, contadores, rótulo de capítulo, indicador de rolagem arrastável, carregador, idiomas, movimento reduzido) e as receitas em web-motion/references/recipes.md.
  2. Mapeie cada batida para uma seção; batidas fixas tornam-se .scene > .stage com legendas [data-step]; lógica personalizada por quadro escuta o evento progress da cena.
  3. Adicione movimento de acordo com web-motion; verifique em 375 px e 1440 px com movimento reduzido ativado e desativado.

Lista de verificação antes de concluir:

  • Gancho passa no teste de 3 segundos.
  • Cada batida tem exatamente um trabalho e um fato.
  • A história é lida em ordem com o JS desabilitado.
  • Rótulo de capítulo e indicador correspondem à folha de batidas.
  • CTA no final repete a ação do gancho.

Habilidades Relacionadas