Claude Eye: 프레임별 애니메이션 분석
당신은 비디오를 볼 수 없지만, 이미지는 읽을 수 있습니다. 이 스킬은 비디오를 타임스탬프가 있는 프레임 세트로 변환하고, 각 프레임을 살펴보며 모든 애니메이션 요소가 무엇을 하고 있는지 기록한 다음, 이러한 관찰 결과를 타임라인으로 변환하여 요소들이 정확히 언제 동기화에서 벗어나는지 보여줍니다. CSS/JS 애니메이션의 타이밍 버그는 일반적으로 100-300ms 정도로, 육안으로 보기에는 너무 빠르지만 프레임 테이블에서는 쉽게 확인할 수 있습니다.
스크립트는 이 파일 옆의 scripts/ 디렉토리에 있습니다. Node 18+와 ffmpeg/ffprobe만 필요하며, npm install은 필요하지 않습니다. 아래에서 <skill>은 이 스킬의 디렉토리를 의미합니다.
1. 사전 요구 사항 확인
ffmpeg -version을 실행합니다. ffmpeg가 없는 경우 사용자에게 알리고 해당 OS의 설치 명령어를 알려줍니다 (Windows: winget install Gyan.FFmpeg 또는 choco install ffmpeg; macOS: brew install ffmpeg; Linux: sudo apt install ffmpeg). 설치 후 새 터미널이 필요합니다. 사용자에게 묻지 않고 직접 설치하지 마세요.
2. 프레임 추출
node <skill>/scripts/extract_frames.mjs <video> --fps 5 --out ./claude-eye-output [--start S] [--end S] [--width 960]
이 명령어는 frames/frame_NNNN.png 파일과 각 프레임 번호를 타임스탬프에 매핑하는 manifest.json 파일을 생성합니다. 항상 매니페스트에서 타임스탬프를 가져오고, 직접 계산하지 마세요.
이미지 읽기 예산을 관리하세요. 각 프레임을 읽을 때마다 컨텍스트가 소모되므로, 한 번에 약 40개 또는 그 이하의 프레임을 목표로 하세요:
- 짧은 클립 (약 8초 미만): 전체에 대해 5fps이면 충분합니다.
- 긴 클립 또는 문제 위치를 모르는 경우: 먼저 전체 비디오에 대해 낮은 fps(
--fps 1또는2)로 대략적인 패스를 수행하여 요소가 움직이는 위치를 찾습니다. 그런 다음 해당 윈도우만 더 높은 fps(--start/--end,--fps 10-15)로 별도의--out디렉토리에 다시 추출합니다. 세부 패스 결과를 보고합니다. - 사용자가 특정 순간을 언급하는 경우 ("약 3초", "제목이 나타날 때"), 바로 해당 윈도우로 이동합니다.
기본 960px 너비는 불투명도와 위치를 판단하기에 충분합니다. 요소가 아주 작은 경우에만 더 큰 --width를 사용하세요.
3. 프레임을 보고 관찰 내용 기록
Read 도구를 사용하여 프레임을 순서대로 읽습니다. 각 프레임에서 애니메이션 중이거나 애니메이션될 수 있는 모든 보이는 텍스트/UI 요소(제목, 부제목, 버튼, 이미지, 강조 표시 범위, 오버레이 등)를 기록합니다.
선택자 이름을 프레임 전체에서 일관되게 유지하세요: 요소를 처음 볼 때 설명적인 케밥-케이스 이름(hero-title, subtitle, cta-button)을 선택하고 이후 모든 프레임에서 정확히 그 이름을 재사용합니다. 타임라인은 이름으로 프레임을 연결하므로, 한 프레임에서 hero-title이고 다음 프레임에서 title이면 두 개의 다른 요소가 되어 분석이 망가집니다. 요소가 나타났거나 존재하는 것으로 알려진 경우 0% 상태로 포함하세요. 그러면 "숨김 → 전환 중" 지점이 표시됩니다.
각 요소에 대해 다음을 추정합니다:
opacity_percent(0-100). 배경 및 이후 프레임에서 요소가 완전히 보이는 모습과 비교하여 판단합니다. 또한 부분 공개도 계산합니다: clip-path 또는 mask wipe가 40% 공개된 경우 40으로 계산합니다.state:hidden(≤10%),transitioning-in(증가 중),visible(≥90%),transitioning-out(감소 중) 중 하나입니다. 인접 프레임과 비교하여 "in"과 "out"을 구분합니다.- 선택 사항:
has_gradient,has_blur, 및 이동("translateY ~20px above final position"), 크기 조절, 흐림 정도, 색상 변경과 같은 내용을 위한notes입니다. 이동과 크기 조절은 불투명도만큼 중요하므로, 볼 때notes에 기록하세요.
모든 내용을 <out>/frames.json에 기록합니다:
[
{
"frame": 1,
"elements": [
{ "selector": "hero-title", "opacity_percent": 0, "state": "hidden" },
{ "selector": "subtitle", "opacity_percent": 0, "state": "hidden" }
],
"overall_state": "pre-animation",
"observation": "히어로 영역이 비어 있음; 아직 렌더링된 요소 없음."
}
]
frame은 매니페스트의 프레임 번호와 일치해야 합니다. 타임스탬프는 매니페스트에서 채워집니다. 긴 실행의 경우, 40개의 프레임을 메모리에 보관하는 대신 진행하면서 파일을 청크 단위로 기록하세요.
압축된 비디오의 불투명도는 근사치입니다. 프레임 간 ±10%의 차이는 노이즈입니다. 여러 프레임에 걸친 패턴이 신호입니다.
4. 보고서 작성
node <skill>/scripts/build_report.mjs ./claude-eye-output --context "애니메이션이 수행해야 하는 작업"
이 명령어는 report.md (요약, 불투명도 타임라인 테이블, 요소별 타이밍, 전환 지점, 비동기 이벤트, 관찰 내용) 및 analysis.json을 생성합니다. 비동기(desync)는 일부 요소가 완전히 보이는 반면 다른 요소는 여전히 전환 중이고, 요소 간 불투명도 차이가 40포인트 이상인 프레임입니다. --spread N을 사용하여 이 기준을 더 엄격하거나 느슨하게 만들 수 있습니다.
5. 해석: 여기서 당신의 가치가 드러납니다
스크립트는 언제 일이 발생하는지 찾습니다. 당신의 역할은 왜 발생하는지와 무엇을 변경해야 하는지 설명하는 것입니다:
report.md의<!-- RECOMMENDATIONS -->섹션을 구체적인 분석 결과로 대체합니다. 요소 타이밍 테이블을 읽으십시오: 예를 들어, "subtitle이hero-title보다 200ms 늦게 시작하여 400ms 후에 완전한 불투명도에 도달하는데, 이는 더 긴 지속 시간과 지연(delay)을 가리킵니다." 프레임 간격을 밀리초로 변환하려면 프레임 간격(1/fps)을 사용하십시오.- 사용자의 소스 코드를 사용할 수 있는 경우, 이러한 요소에 대한 CSS/JS(
transition,animation,@keyframes,transition-delay, framer-motion/GSAP 설정)를 찾아 관찰된 타이밍을 설명하는 정확한 라인을 지적하십시오. 구체적인 수정 방안을 제안하십시오. - 타이밍 정확도(±1 프레임 = ±1/fps 초)를 언급하십시오. 결론이 한 프레임보다 작은 간격에 의존하는 경우, 주장하기 전에 해당 윈도우를 더 높은 fps로 다시 추출하십시오.
그런 다음 채팅에서 사용자에게 짧은 요약을 제공하십시오: 애니메이션되는 대상, 주요 타이밍, 각 비동기(desync)의 타임스탬프 및 가능한 원인, 그리고 수정 방안. report.md 파일의 경로를 포함하십시오.
불투명도만 있는 것은 아닙니다
보고서 파이프라인은 불투명도/가시성을 중심으로 구축되었지만, 동일한 프레임 읽기 접근 방식은 레이아웃 이동, 요소 점프, 깜빡임(잘못된 상태의 한 프레임), 로더가 필요할 때 회전하지 않는 경우, 또는 선형으로 보이는 이징과 같은 다른 질문에도 작동합니다. 이러한 경우에도 프레임을 추출하여 읽으십시오. build_report.mjs를 건너뛰고 매니페스트의 프레임 참조 타임스탬프를 사용하여 직접 답변할 수 있습니다.