Locomotive Scroll 스킬
API 버전과 접근성을 확인하며 부드러운 스크롤, 시차와 GSAP 통합을 계획합니다.
커뮤니티 · 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.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.
Claude Code: 플러그인 마켓플레이스에서 설치
- 터미널에서
claude로 Claude Code를 시작합니다. - 마켓플레이스를 추가합니다(컴퓨터마다 한 번):
/plugin marketplace add freshtechbro/claudedesignskills - 플러그인을 설치합니다. Claude Code가 먼저 세부 정보를 보여 줍니다. 무엇이 추가되는지(스킬, 훅, MCP 서버) 확인한 다음, 나만 쓸지, 이 저장소의 모든 사람이 쓸지, 이 저장소에서 나만 쓸지 고르세요.
/plugin install locomotive-scroll@claude-design-skillstack - /를 입력해
/locomotive-scroll:locomotive-scroll가 있는지 확인하거나, 그냥 작업을 요청하세요.
세션 대신 셸에서 설치하려면:
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는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /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에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. 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 SkillstackReact 모션 컴포넌트, 퇴장 전환, 변형, 제스처와 레이아웃 애니메이션을 만듭니다.애니메이션 성능 개선 스킬
커뮤니티 · ibelick측정, 스크롤 작업, 페인트 비용과 합성 동작을 검토해 애니메이션 끊김을 개선합니다.썸네일 디자인 스킬
커뮤니티 · Frank Heijdenrijk내용에 충실하고 모바일에서 읽기 좋은 영상 썸네일을 기획하고 기본 비교 테스트를 계획합니다.디자인과 템플릿 스킬
커뮤니티 · Frank Heijdenrijk반복 SNS 그래픽용 재사용 브랜드 키트, 템플릿 묶음, 제작 절차를 정의합니다.인용 카드와 텍스트 그래픽 스킬
커뮤니티 · Frank Heijdenrijk출처 있는 한 줄을 고르고 인용을 꾸며내지 않는 읽기 좋은 타이포 카드를 기획합니다.Pinterest 핀 디자인 스킬
커뮤니티 · Frank Heijdenrijk실제 목적지에 맞는 세로 Pinterest 콘셉트와 읽기 좋은 키워드 문구·서로 다른 변형을 기획합니다.