Locomotive Scroll 技能
规划平滑滚动、视差与 GSAP 集成,并检查 API 版本和无障碍。
社区 · Claude Design Skillstack| 作者 | Claude Design Skillstack |
|---|---|
| 许可证 | MIT (LICENSE); Apache-2.0 (plugin.json) |
| 来源 | freshtechbro/claudedesignskills · GitHub 上的 SKILL.md |
| 项目官网 | scroll.locomotive.ca |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
locomotive-scroll 为编程代理提供平滑滚动、视差、视口检测与 GSAP 集成模式。
示例包含较旧的容器与 scrollerProxy API。官网目前介绍基于 Lenis 的 v5 重写,请匹配已安装版本,不要原样复制旧代码。
摘自该技能的 SKILL.md: # Locomotive Scroll
功能
- 检查滚动容器,选择适当的增强行为。
- 连接视差、视口事件及可选 GSAP 时间轴。
- 刷新测量,并在生命周期变化时销毁实例。
产出内容
- 滚动配置与集成代码。
- 受影响页面的版本与无障碍检查。
适用场景
- 维护已有 Locomotive Scroll 集成。
- 规划匹配版本、保留原生回退的视差增强。
不适用的场景
- 把旧版私有 API 直接用于新 v5 项目。
所需条件
- JavaScript 应用及对应版本的 Locomotive Scroll。
- 仅集成模式需要 GSAP;可选配置助手需要 Python 3。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 滚动行为与集成模式。 |
scripts/generate_config.py | 配置样板代码。 |
scripts/integration_helper.py | 框架与 GSAP 集成示例。 |
references/api_reference.md | 随附 API 参考。 |
2026-11-17 在仓库中查到的许可证:MIT (LICENSE); Apache-2.0 (plugin.json)。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 提出视差修改前,先确认我们安装的 Locomotive Scroll 版本。
- 审查此集成中的固定定位与键盘导航问题。
- 添加清理和减少动态效果回退,不更改页面内容。
如何安装 locomotive-scroll
旧版示例
v5 项目请以官方 v5 文档为准。技能中的旧平滑容器配置及内部 scroll.instance 访问方式需要调整。
根目录 MIT 许可与插件元数据 Apache-2.0 冲突,重新分发时应说明这一未解决的上游差异。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:从插件市场安装
- 在终端中用
claude启动 Claude Code。 - 添加插件市场(每台电脑一次):
/plugin marketplace add freshtechbro/claudedesignskills - 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
/plugin install locomotive-scroll@claude-design-skillstack - 输入 / 查找
/locomotive-scroll:locomotive-scroll,或直接提出任务。
也可以不进入会话,直接在 shell 中运行:
claude plugin marketplace add freshtechbro/claudedesignskills
claude plugin install locomotive-scroll@claude-design-skillstackClaude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
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 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /locomotive-scroll,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
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/| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
按版本维护
检查时官网显示基于 Lenis 的 v5.1。这是注明日期的观察,不是永久有效的软件包要求。
请在真实应用中测试焦点导航、锚点、手机触摸和路由清理。视觉顺滑不能单独证明可用性。
关于 locomotive-scroll 的常见问题
这是当前官方技能吗?
不是。它是社区资料,部分示例早于当前官方库的重写。
所有滚动都应该平滑处理吗?
不应该。请兼顾键盘导航、减少动态效果和手机操作,并保留可用的原生路径。
需要 GSAP 吗?
只有请求的集成使用 GSAP ScrollTrigger 时才需要。基本滚动只需 Locomotive Scroll 本身。
固定定位为什么会出问题?
旧集成中经过变换的滚动容器可能改变包含块。请检查实际库版本与 DOM 结构。
更多 AI 技能
相关技能
Motion 与 Framer Motion 技能
社区 · Claude Design Skillstack编写 React 动效组件、退出过渡、变体、手势与布局动画。动画性能修复技能
社区 · ibelick检查测量、滚动工作、绘制成本与合成行为,修复动画卡顿。缩略图设计 技能
社区 · Frank Heijdenrijk规划真实、适合手机阅读的视频缩略图简报,并设计原生对比测试。设计与模板 技能
社区 · Frank Heijdenrijk为周期性社交图形制定可复用品牌套件、模板系列及制作流程。引用卡片与文字图形 技能
社区 · Frank Heijdenrijk选择一句有力原文并正确署名,规划易读文字卡片,不编造引文。Pinterest 图钉设计 技能
社区 · Frank Heijdenrijk规划竖版 Pinterest 图钉概念,搭配易读关键词叠字及针对真实目标页的不同方案。