Saltar al contenido

Locomotive Scroll skill

Planifica scroll suave, paralaje e integración GSAP comprobando versiones de API y accesibilidad.

Comunidad · Claude Design Skillstack
AutorClaude Design Skillstack
LicenciaMIT (LICENSE); Apache-2.0 (plugin.json)
Fuentefreshtechbro/claudedesignskills · SKILL.md en GitHub
Sitio del proyectoscroll.locomotive.ca
Funciona enClaude Code · Codex, Gemini CLI, Cursor, Copilot
Leída en la fuente el

locomotive-scroll ofrece patrones de desplazamiento suave, paralaje, detección de pantalla e integración GSAP para agentes.

Incluye contenedores y API scrollerProxy antiguos. El sitio oficial describe v5 reescrito sobre Lenis; adapta a la versión instalada, sin copiar los ejemplos sin cambios.

Del SKILL.md de la skill: # Locomotive Scroll

Esta es una skill de la comunidad creada por Claude Design Skillstack, sin revisar por nosotros ni por Anthropic. Las skills pueden indicar al agente que ejecute código, lea archivos o acceda a la red. Antes de instalarla, lee su SKILL.md y cada script de la carpeta, y busca cualquier cosa que no encaje con lo que dice hacer.

Qué hace

  1. Inspecciona contenedores y selecciona mejoras adecuadas.
  2. Conecta paralaje, eventos de visibilidad y líneas temporales GSAP opcionales.
  3. Actualiza medidas y destruye instancias al cambiar el ciclo de vida.

Qué obtienes

  • Configuración de scroll y código de integración.
  • Comprobaciones de versión y accesibilidad de la página afectada.

Cuándo usarla

  • Mantener una integración Locomotive Scroll existente.
  • Planificar paralaje según la versión con alternativa nativa.

Cuándo no usarla

  • Aplicar API privadas antiguas directamente a un proyecto v5 nuevo.

Qué necesita

  • Aplicación JavaScript con la versión correspondiente de Locomotive Scroll.
  • GSAP solo para sus integraciones; Python 3 para asistentes opcionales.

Archivos de la skill

Archivo o carpetaPara qué sirve
SKILL.mdPatrones de comportamiento e integración de scroll.
scripts/generate_config.pyCódigo base de configuración.
scripts/integration_helper.pyEjemplos de integración con frameworks y GSAP.
references/api_reference.mdReferencia de API incluida.

Licencia según el repositorio el 2026-11-17: MIT (LICENSE); Apache-2.0 (plugin.json).

Prompts de ejemplo

Escribe uno de estos después de instalarla; si nombras la skill, te aseguras de que se use.

  • Identifica nuestra versión instalada antes de proponer cambios de paralaje.
  • Audita esta integración por problemas de posición fija y navegación con teclado.
  • Añade limpieza y alternativa de movimiento reducido sin cambiar el contenido.

Cómo instalar locomotive-scroll

Ejemplos antiguos

Usa la documentación oficial v5 para proyectos v5. La configuración antigua y el acceso interno scroll.instance requieren adaptación.

MIT raíz entra en conflicto con Apache-2.0 en los metadatos. Mantén visible la discrepancia sin resolver al redistribuir.

Una skill es una carpeta con un archivo SKILL.md. La instalas una vez; el agente lee su breve descripción al empezar cada sesión y carga las instrucciones completas solo cuando una petición encaja. Elige dónde la usas:

Claude Code: desde el marketplace de plugins

  1. Abre Claude Code en una terminal con claude.
  2. Añade el marketplace (una vez por ordenador):
    /plugin marketplace add freshtechbro/claudedesignskills
  3. Instala el plugin. Claude Code muestra antes sus detalles: comprueba qué va a añadir (skills, hooks, servidores MCP) y elige si es para ti, para todos en este repositorio o solo para ti en este repositorio.
    /plugin install locomotive-scroll@claude-design-skillstack
  4. Escribe / y busca /locomotive-scroll:locomotive-scroll, o simplemente pide la tarea.

Desde tu shell en lugar de una sesión:

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

Claude Code: copia la carpeta en tu carpeta de skills

Pon la carpeta de la skill en ~/.claude/skills/ para usarla en todos los proyectos de este ordenador, o en .claude/skills/ dentro de un repositorio para compartirla con todos los que trabajan en él (haz 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/

Claude Code detecta las skills nuevas o modificadas en estas carpetas durante la sesión. Si la carpeta de skills no existía al empezar la sesión, ejecuta /reload-skills una vez. Después escribe /locomotive-scroll o simplemente describe la tarea.

En Windows, ejecuta los comandos en Git Bash o WSL, o copia la carpeta al mismo sitio con el Explorador de archivos.

Codex, Gemini CLI, Cursor y GitHub Copilot

Estos agentes leen las mismas carpetas SKILL.md. La única carpeta que aceptan los cuatro dentro de un proyecto es .agents/skills/, así que esto copia la skill ahí:

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/
AgenteCarpeta del proyectoTu carpeta de usuarioNotas
OpenAI Codex
.agents/skills/
~/.agents/skills/
Escribe $ o ejecuta /skills para elegir una skill; Codex también elige una cuando tu tarea encaja.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
O instálala desde Git con gemini skills install <git URL> --path <folder> --consent. El 18 de junio de 2026, Google sustituyó Gemini CLI por Antigravity CLI para los usuarios del nivel gratuito y de Google One; Antigravity usa .agents/skills/ en un proyecto y ~/.gemini/config/skills/ para ti.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Escribe / en el chat de Agent para elegir una skill. Cursor también lee las carpetas .claude/skills/ de Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Funciona en Copilot CLI, en el agente en la nube y en el modo agente de VS Code, Visual Studio y JetBrains (la compatibilidad con cada IDE depende de la versión). O ejecuta gh skill install OWNER/REPOSITORY SKILL (vista previa pública, GitHub CLI 2.90.0 o posterior).
Instala solo skills de confianza. Anthropic aconseja usar solo skills de fuentes de confianza y leer todos los archivos de cualquier otra skill antes de usarla: una skill puede indicar al agente que ejecute comandos, lea archivos o envíe datos de formas que su descripción no menciona.

Fuentes de estos pasos

Comprobado con la documentación de cada proveedor el 2026-11-14:

Mantenimiento según la versión

El sitio oficial consultado muestra v5.1 sobre Lenis. Es una observación fechada, no un requisito permanente de paquete.

Prueba foco, anclas, gestos móviles y limpieza de rutas en la aplicación real. La suavidad visual no demuestra usabilidad.

Preguntas sobre locomotive-scroll

¿Es la skill oficial actual?

No. Es material comunitario con ejemplos anteriores a la reescritura actual de la biblioteca.

¿Todo scroll debe suavizarse?

No. Respeta teclado, movimiento reducido y comportamiento móvil; conserva una vía nativa utilizable.

¿Necesita GSAP?

Solo para la integración solicitada con GSAP ScrollTrigger. El desplazamiento básico usa Locomotive Scroll.

¿Por qué falla la posición fija?

Los contenedores transformados pueden cambiar el bloque de referencia en integraciones antiguas. Comprueba versión y estructura DOM reales.

Más skills de IA

Skills relacionadas

Categorías de skills