Communitygithub.com

MengTo/Skills - 브라우저 동영상 녹화

Codex 인앱 브라우저 캡처로 60fps 4:3 4K 브라우저 화면 녹화 스타일의 동영상을 생성합니다. 브라우저 전용 크롭, macOS 커서 스타일, 클릭 동작, 줌 팔로우 프레이밍, ffprobe/썸네일 검증 및 네이티브 녹화 호환성 확인을 지원합니다.

Skills - 브라우저 동영상 녹화란 무엇인가요?

이 스킬은 Codex의 인앱 브라우저 캡처를 활용하여 고품질의 브라우저 데모 동영상을 제작하는 전문 도구입니다. macOS의 자연스러운 커서, 미묘한 클릭 스케일, 차분한 줌 팔로우 프레이밍을 갖춘 60fps 4:3 4K MP4를 생성합니다. 브라우저 제어와 프레임 소싱은 Browser 스킬/MCP를 사용하며, 로컬 Python 스크립트가 실제로 렌더링을 수행합니다. 선택적으로 네이티브 녹화 MCP와 통합할 수 있지만, 기본적으로는 스크린샷 기반 렌더링이 주된 워크플로입니다. CLI 명령어로 설정 파일을 생성하고 ffprobe로 최종 동영상을 검증하며, 중간 썸네일을 추출하여 커서 위치, 해상도, 프레임률을 확인합니다. Codex, Playwright 또는 MCP가 자연스러운 브라우저 데모 동영상을 생성할 수 있는지 물어볼 때 유용합니다.

지원 대상~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/MengTo/Skills/tree/HEAD/agent-skills/codex/browser-video-recording

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

브라우저 동영상 녹화

종속성 모델

워크플로를 세 계층으로 분리하세요:

  1. 브라우저 제어 및 소스 프레임: Codex 인앱 브라우저를 Browser 스킬/MCP를 통해 사용하세요. 사용자가 Codex 브라우저를 요청하거나 프로젝트에서 금지하지 않는 한 Chrome을 사용하지 마세요. 브라우저 계층은 실제 스크린샷과 실제 클릭/스크롤/탐색 상태를 제공합니다.
  2. 로컬 비디오 렌더러: 번들 Python 스크립트를 사용하여 스크린샷을 자연스러운 macOS 커서, 미묘한 클릭 스케일, 차분한 줌 팔로우 프레이밍이 있는 MP4로 렌더링합니다. 이는 스크린 녹화 MCP가 필요하지 않습니다.
  3. 선택적 네이티브 녹화기 통합: 네이티브 녹화 MCP는 호출 가능하고 실제 앱 녹화를 시작/중지하거나 생성된 프로젝트를 여는 데 명시적으로 유용한 경우에만 사용하세요. 사용할 수 없거나, 차단되었거나, Codex 브라우저 표면을 캡처할 수 없는 경우 스크린샷-비디오 렌더러로 폴백하고 그 이유를 설명하세요.

자체 포함 실행

이 스킬은 전체 스킬 폴더가 설치되어 있고 scripts/render_browser_demo.py가 포함되어 있다면 다른 Codex 인스턴스가 Python 렌더링을 수행하기에 충분합니다. Codex는 렌더러를 다시 만들지 말고 번들 스크립트를 실행해야 합니다.

필요한 로컬 도구:

  • python3
  • Python 패키지 Pillow
  • ffmpeg 및 ffprobe

선택적 macOS 커서 추출은 swift와 /usr/sbin/screencapture를 사용합니다. 이들을 사용할 수 없는 경우 cursor_asset을 통해 투명 PNG를 제공하고 설정에서 cursor_hotspot을 지정하세요.

Browser 스킬/MCP는 새로운 Codex 인앱 브라우저 스크린샷을 위해 여전히 필요합니다. 사용할 수 없는 경우 사용 가능한 최고의 브라우저 자동화 스크린샷 소스를 사용하고 폴백임을 명시하세요.

선택적 네이티브 녹화기 지원

네이티브 앱 녹화의 경우 MCP가 다음을 지원하는지 확인하세요:

  • frameRate: 60 사용.
  • resolutionRawValue: "4K" 사용.
  • 영역 녹화 시 ratioPresetRawValue: "4:3" 사용.
  • 포함된 브라우저 뷰포트로 크롭할 때 명시적 selectedRegionOnScreen 사용.

로컬 렌더러의 경우 4K 4:3은 3840x2880 을 의미합니다. 네이티브 녹화기가 4K 열거형을 노출하면 앱 측 해상도 프리셋으로 처리하고 해당 MCP를 통해 녹화할 때 4:3 영역 선택과 짝지으세요.

캡처 워크플로

먼저 browser:control-in-app-browser를 사용하세요. 문서를 로드한 후, Node/브라우저 API로 인앱 브라우저를 구동하세요:

  • 4:3 4K 출력을 위해 뷰포트를 1920x1440으로 설정한 후, 마칠 때 재설정하세요.
  • 요청된 페이지로 이동하고 실제 클릭, 뒤로 가기, 검색, 스크롤을 수행하세요.
  • 각 중요한 상태 변경 후 브라우저 전용 스크린샷을 저장하세요. 01-results-top.png, 02-after-card-click.png, 03-back-results.png와 같은 이름을 사용하세요.
  • 각 클릭/스크롤 대상의 뷰포트 좌표를 기록하세요. 최종 커서 경로는 해당 지점에 도달하고, 멈추며, 클릭한 후 다음 의미 있는 지점으로 이동해야 합니다.

사용자가 명시적으로 시스템 UI를 필요로 하지 않는 한 데스크톱 좌표 자동화는 피하세요. Codex 브라우저 가시성은 캡처 가능한 macOS 표면을 노출하지 않을 수 있습니다. 브라우저 API의 스크린샷이 신뢰할 수 있는 소스입니다.

모션 규칙

커서가 의도적으로 움직이도록 만드세요:

  • 드물고 대부분 직선인 커서 경로를 사용하세요.
  • 대상에서 클릭하기 전에 잠시 멈추세요.
  • 관련 없는 UI 위를 배회하지 마세요.
  • 클릭 후에 페이지 전환이 일어나도록 하고, 클릭 전에는 일어나지 않도록 하세요.
  • 미묘한 클릭 피드백만 사용하세요: 스케일 딥/리바운드, 요청하지 않은 경우 장식용 링은 사용하지 마세요.
  • 줌 팔로우는 커서보다 차분하게 유지하세요. 카메라는 클릭된 콘텐츠를 프레이밍해야 하며, 모든 작은 마우스 움직임을 쫓지 않아야 합니다.

기본 시각적 대상:

  • 컴포지터에서 추출한 실제 macOS 포인터 또는 기존 투명 커서 에셋.
  • 편집된 데모 녹화에서 일반적으로 사용되는 큰 커서 스타일에 맞춰 커서 스케일 3.0.
  • 미묘한 클릭 스케일 딥을 위한 클릭 애니메이션 강도 15.
  • 회전 강도는 수평 속도로부터 최대 8deg.

렌더 스크립트

결정론적 60fps 4:3 4K 출력을 위해 scripts/render_browser_demo.py를 사용하세요:

python3 /path/to/browser-video-recording/scripts/render_browser_demo.py \
  --config /tmp/browser-demo-config.json \
  --output /tmp/browser-demo-4x3-4k-60fps.mp4

시작 설정 생성:

python3 /path/to/browser-video-recording/scripts/render_browser_demo.py --write-template

설정 항목:

  • shots: 상태 이름을 스크린샷 PNG 경로에 매핑.
  • scene_starts: [time, shotName, transition] 항목.
  • cursor_keys: [time, x, y] 뷰포트 좌표 항목.
  • camera_keys: [time, x, y, zoom] 항목.
  • click_times: 클릭 타임스탬프.
  • duration, fps, output_size, source_size, cursor_scale.

선호 기본값:

{
  "fps": 60,
  "output_size": [3840, 2880],
  "source_size": [1920, 1440]
}

cursor_asset이 생략되면 스크립트가 잠시 단색 오버레이를 표시하고 screencapture를 사용하여 실제 현재 macOS 커서를 투명 PNG로 추출합니다. 이는 로컬 렌더링 지원이며 MCP 종속성이 아닙니다.

검증

항상 전달된 비디오를 검증하세요:

ffprobe -v error \
  -show_entries stream=codec_name,width,height,r_frame_rate \
  -show_entries format=duration,size \
  -of json /path/to/output.mp4

비디오 중간의 썸네일을 하나 이상 추출하고 검사하세요:

ffmpeg -y -ss 8 -i /path/to/output.mp4 -frames:v 1 -update 1 /tmp/browser-demo-thumb.png

다음을 확인하세요:

  • 해상도는 요청된 출력이며, 일반적으로 4:3 4K의 경우 3840x2880입니다.
  • 프레임률은 60/1 또는 이에 상응합니다.
  • 재생 시간이 요청과 일치합니다.
  • 커서가 보이고, 자연스럽고, 대상에 위치합니다.
  • 비디오가 브라우저 콘텐츠로 크롭되었으며 데스크톱이 아닙니다.
  • 브라우저 뷰포트 오버라이드가 재설정되었습니다.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

MengTo/Skills

Generate ElevenLabs text-to-speech audio from scripts or inline text using local voice profiles. Use when the user asks for ElevenLabs, text-to-speech, TTS, narration, voiceover, speech audio, or voice generation; load voice names, voice ids, emails, owners, and account-specific defaults only from local config outside the skill.

MengTo/Skills

Profile, audit, and optimize frontend page performance with emphasis on animation work, memory-leak risks, long-session slowdowns, CSS animations, canvas/WebGL requestAnimationFrame loops, marquees, skeletons, GSAP/Three/Matter effects, timers, listeners, and observers. Use when the user asks to make animations performant, pause offscreen animations, look for memory leaks, profile pages that slow the computer over time, fix janky scrolling, reduce CPU/GPU use, or repeat the "only play in view" optimization on React/Vite/Next/frontend pages using Codex Browser.

MengTo/Skills

Turn a reference video into a super detailed recreation or inspiration prompt. Use when the user provides, mentions, uploads, links, or points to a video and asks to analyze the design, UI, animations, transitions, scroll interactions, typography, colors, assets, WebGL/Three.js, storytelling, section-by-section behavior, or to create a prompt/article that recreates the page, app, interaction, or motion system.

MengTo/Skills

Create an on-scroll animation trigger using IntersectionObserver with Tailwind-friendly animation classes and keyframes. Use when asked for scroll-reveal, animate-on-scroll, or sequencing element animations when they enter the viewport.

MengTo/Skills

Use when designing or implementing product-grade web motion like Stripe, Linear, Apple, and Vercel. Covers motion principles, easing/duration defaults, choreography patterns, scroll/hover interactions, performance, accessibility (reduced motion), and implementation guidance.

MengTo/Skills

Create premium cinematic web motion systems with GSAP, ScrollTrigger, and Lenis. Use for luxury editorial websites, creative studio portfolios, Awwwards-style interactions, smooth scroll reveals, staggered text, parallax, pinned sections, magnetic hover states, custom cursors, and mouse-reactive layered movement.

MengTo/Skills

Create cinematic scroll-driven landing pages with Lenis smooth scrolling, GSAP ScrollTrigger, scroll-linked progression, staggered text reveals, sticky card stacks, parallax backgrounds, scroll-scrubbed transitions, footer reveals, and immersive preloaders. Use when analyzing or building premium editorial scroll experiences, sticky project stacks, kinetic typography, or section-by-section storytelling.

MengTo/Skills

Use when designing or rewriting a high-converting SaaS pricing page (structure, plan design, copywriting, SEO/AEO, FAQs, layout patterns, experiments). Includes checklists, templates, and common pitfalls.

MengTo/Skills

Use when creating or refining WebGL-heavy landing pages and you need to steer toward a specific visual outcome (premium, technical, playful, cinematic) while balancing conversion clarity, performance, and implementation complexity.

관련 스킬