Pular para o conteúdo

Locomotive Scroll skill

Planeje rolagem suave, paralaxe e integração GSAP, conferindo versões de API e acessibilidade.

Comunidade · Claude Design Skillstack
AutorClaude Design Skillstack
LicençaMIT (LICENSE); Apache-2.0 (plugin.json)
Fontefreshtechbro/claudedesignskills · SKILL.md no GitHub
Site do projetoscroll.locomotive.ca
Funciona emClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lido na fonte em

locomotive-scroll fornece padrões de rolagem suave, paralaxe, viewport e integração GSAP para um agente de programação.

Os exemplos incluem APIs antigas de contêiner e scrollerProxy. O site oficial descreve a reescrita v5 baseada em Lenis; adapte à versão instalada em vez de copiar sem mudanças.

Do SKILL.md da skill: # Locomotive Scroll

Esta é uma skill da comunidade, de Claude Design Skillstack, sem verificação nossa nem da Anthropic. Skills podem mandar o agente executar código, ler arquivos ou acessar a rede. Antes de instalar, leia o SKILL.md e todos os scripts da pasta, e procure qualquer coisa que não corresponda ao que ela diz fazer.

O que ela faz

  1. Inspecione contêineres de rolagem e selecione melhorias adequadas.
  2. Conecte paralaxe, eventos de viewport e linhas do tempo GSAP opcionais.
  3. Atualize medições e destrua instâncias nas mudanças de ciclo de vida.

O que você recebe

  • Configuração de rolagem e código de integração.
  • Verificações de versão e acessibilidade da página afetada.

Quando usar

  • Manter uma integração Locomotive Scroll existente.
  • Planejar paralaxe compatível com a versão e alternativa nativa.

Quando não usar

  • Aplicar APIs privadas antigas diretamente a um projeto v5 novo.

O que ela exige

  • Aplicação JavaScript e versão correspondente de Locomotive Scroll.
  • GSAP apenas para seus padrões de integração; Python 3 para auxiliares opcionais de configuração.

Arquivos da skill

Arquivo ou pastaPara que serve
SKILL.mdComportamento de rolagem e padrões de integração.
scripts/generate_config.pyEstrutura de configuração.
scripts/integration_helper.pyExemplos de integração com frameworks e GSAP.
references/api_reference.mdReferência de API incluída.

Licença conforme encontrada no repositório em 2026-11-17: MIT (LICENSE); Apache-2.0 (plugin.json).

Prompts de exemplo

Digite um destes depois de instalar; citar a skill pelo nome garante que ela seja usada.

  • Identifique nossa versão instalada de Locomotive Scroll antes de propor mudanças de paralaxe.
  • Audite esta integração quanto a posicionamento fixo e navegação por teclado.
  • Adicione limpeza e alternativa de movimento reduzido sem alterar o conteúdo da página.

Como instalar a skill locomotive-scroll

Exemplos antigos

A documentação oficial v5 é a referência para projetos v5. Configurações antigas de contêiner e acesso interno a scroll.instance nesta skill exigem adaptação.

A licença MIT raiz diverge dos metadados Apache-2.0 do plugin. Mantenha visível essa inconsistência não resolvida ao redistribuir.

Uma skill é uma pasta com um arquivo SKILL.md. Você instala uma vez; o agente lê a descrição curta no início de cada sessão e só carrega as instruções completas quando um pedido corresponde a ela. Escolha onde você usa:

Claude Code: pelo marketplace de plugins

  1. Abra o Claude Code em um terminal com claude.
  2. Adicione o marketplace (uma vez por computador):
    /plugin marketplace add freshtechbro/claudedesignskills
  3. Instale o plugin. O Claude Code mostra os detalhes primeiro: confira o que ele vai adicionar (skills, hooks, servidores MCP) e escolha se ele é para você, para todos neste repositório ou só para você neste repositório.
    /plugin install locomotive-scroll@claude-design-skillstack
  4. Digite / e procure /locomotive-scroll:locomotive-scroll, ou simplesmente peça a tarefa.

Pelo shell, em vez de dentro de uma sessão:

claude plugin marketplace add freshtechbro/claudedesignskills
claude plugin install locomotive-scroll@claude-design-skillstack

Claude Code: copie a pasta para a sua pasta de skills

Coloque a pasta da skill em ~/.claude/skills/ para usá-la em todos os projetos deste computador, ou em .claude/skills/ dentro de um repositório para compartilhá-la com todos que trabalham nele (faça o commit).

git clone --depth 1 https://github.com/freshtechbro/claudedesignskills.git
mkdir -p ~/.claude/skills
cp -R claudedesignskills/plugins/individual/locomotive-scroll/skills/locomotive-scroll ~/.claude/skills/

O Claude Code percebe skills novas ou alteradas nessas pastas durante a sessão. Se a pasta de skills não existia quando a sessão começou, execute /reload-skills uma vez. Depois digite /locomotive-scroll ou apenas descreva a tarefa.

No Windows, execute os comandos no Git Bash ou no WSL, ou copie a pasta para o mesmo lugar pelo Explorador de Arquivos.

Codex, Gemini CLI, Cursor e GitHub Copilot

Esses agentes leem as mesmas pastas SKILL.md. A única pasta dentro de um projeto que os quatro aceitam é .agents/skills/, então este comando copia a skill para lá:

git clone --depth 1 https://github.com/freshtechbro/claudedesignskills.git
mkdir -p .agents/skills
cp -R claudedesignskills/plugins/individual/locomotive-scroll/skills/locomotive-scroll .agents/skills/
AgentePasta do projetoSua pasta de usuárioObservações
OpenAI Codex
.agents/skills/
~/.agents/skills/
Digite $ ou execute /skills para escolher uma skill; o Codex também escolhe uma sozinho quando a tarefa corresponde.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou instale pelo Git com gemini skills install <git URL> --path <folder> --consent. Em 18 de junho de 2026, o Google substituiu o Gemini CLI pelo Antigravity CLI para usuários do nível gratuito e do Google One; o Antigravity usa .agents/skills/ no projeto e ~/.gemini/config/skills/ para você.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Digite / no chat do Agent para escolher uma skill. O Cursor também lê as pastas .claude/skills/ do Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funciona no Copilot CLI, no agente na nuvem e no modo agente do VS Code, do Visual Studio e dos IDEs da JetBrains (o suporte nos IDEs depende da versão). Ou execute gh skill install OWNER/REPOSITORY SKILL (prévia pública, GitHub CLI 2.90.0 ou mais recente).
Instale só skills em que você confia. A recomendação da Anthropic é usar skills apenas de fontes confiáveis e ler todos os arquivos de qualquer outra skill antes de usá-la: uma skill pode mandar o agente executar comandos, ler arquivos ou enviar dados de formas que a descrição não menciona.

Fontes destas instruções

Conferido com a documentação de cada fornecedor em 2026-11-14:

Manutenção compatível com a versão

O site oficial consultado informa v5.1 baseada em Lenis. É uma observação datada, não uma exigência de versão permanentemente atual.

Teste foco, âncoras, toque móvel e limpeza de rotas no aplicativo real. Suavidade visual não prova usabilidade.

Perguntas sobre a skill locomotive-scroll

É a skill oficial atual?

Não. É material comunitário com exemplos anteriores à reescrita atual da biblioteca oficial.

Toda rolagem deve ser suavizada?

Não. Respeite teclado, movimento reduzido e comportamento móvel; mantenha um caminho nativo utilizável.

Precisa de GSAP?

Só se a integração solicitada usar GSAP ScrollTrigger. A rolagem básica usa o próprio Locomotive Scroll.

Por que o posicionamento fixo quebra?

Contêineres transformados podem mudar o bloco de referência nas integrações antigas. Confira a versão real da biblioteca e a estrutura DOM.

Mais skills de IA

Skills relacionadas

Categorias de skills