Communitygithub.com

SingleGrain-Team/video-skills

6~8초 길이의 로고 스팅(logo sting)을 제작합니다. 브랜드 마크가 굴절된 액체 구슬 안에서 움직이다가 구슬이 터지면서 마크와 워드마크가 선명하게 화면에 나타납니다. 1920x1080 H.264 MP4와 편집 가능한 HyperFrames 프로젝트 파일로 제공되며, 3D 모델, 스톡 영상 또는 생성 모델을 사용하지 않습니다. 브랜드 인트로/아웃트로, 제품 런칭 오프너, 채널 스팅 및 로고 공개 장면에 활용하세요.

video-skills란 무엇인가요?

이 스킬은 Three.js 기반의 WebGL 유리 구슬 애니메이션을 사용하여 로고 리빌(Liquid Reveal) 효과를 만듭니다. 브랜드 로고(마크)는 굴절률이 높은 액체 구슬 안에 배치되어 처음에는 식별이 불가능할 정도로 왜곡되고, 이후 구슬이 팽창했다가 순간적으로 정지한 뒤 터지면서 로고와 워드마크가 깔끔하게 드러납니다. 최종 결과물은 1920x1080 해상도, H.264 코덱의 MP4 파일과 소스 편집이 가능한 HyperFrames 프로젝트 폴더로 제공됩니다. 특히 모든 프레임이 탐색 시간(seek time)의 함수로 결정론적으로 렌더링되므로 재현성이 보장되며, 애니메이션 효과는 7초 기본 지속 시간에 맞춰 단계별로 구성됩니다. SVG 또는 PNG 로고, 워드마크 텍스트, 세 가지 색상 팔레트를 입력으로 사용하며, 별도의 3D 모델이나 AI 생성 모델을 필요로 하지 않습니다. CLI 기반의 워크플로우(`hyperframes init`, `lint`, `check`, `render`)로 제작되며, Cursor, Codex 등 확장 가능한 개발 환경에서 사용할 수 있도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SingleGrain-Team/video-skills/tree/HEAD/skills/liquid-logo-reveal

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

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

문서

액체 로고 리빌

WebGL (Three.js) 기반의 유리 구슬이 물리적 투과, 노이즈로 변위된 표면, 분산 효과를 가지며 로고 앞에 위치합니다. 로고는 심하게 굴절되어 읽을 수 없습니다. 압력이 쌓이고, 모든 것이 잠시 멈춘 후 구슬이 터지며 15개의 물방울이 튀어 나가고, 마크는 왼쪽으로 슬라이드하며 워드마크가 그 뒤에서 나타납니다. 모든 프레임은 탐색 시간(seek time)의 순수 함수이므로 렌더링이 결정론적입니다.

입력

입력참고 사항
로고 마크SVG 또는 PNG. 마크(심볼)만, 정사각형에 가까움, 투명 배경.
워드마크기본적으로 Inter 폰트로 조판된 텍스트 문자열. 브랜드에 실제 워드마크 그래픽이 있는 경우 "워드마크를 아트워크로"를 참고하세요.
팔레트세 가지 색상: 강한 악센트, 부드러운 틴트, 차분한 중성색. 이것들은 유리 뒤의 흐릿한 색상 필드가 됩니다. 유리는 무색이며 뒤에 있는 것만 보여줍니다. 워드마크의 잉크 색상.
지속 시간기본 7초. 락업이 안착된 후의 멈춤 구간만 늘려야 합니다.

사용자가 제공했거나 브랜드 키트에 있는 자산만 사용하세요. 웹에서 로고를 가져오지 마세요.

래스터 전용 로고

  • 템플릿은 알파 채널이 있는 PNG를 필요로 합니다. 로고에 불투명 배경(JPG, 흰색 박스)이 있는 경우 먼저 제거하세요 (npx hyperframes remove-background, 또는 사용자에게 투명 파일을 요청하세요). 흰색 사각형이 구슬 안에서 굴절되는 결과물을 제공하지 마세요.
  • 작은 PNG(~600px 미만)도 괜찮습니다. 마크가 정지 상태에서 약 250px로 표시되지만 구슬 안에서는 약 360px로 확대되기 때문입니다. 원본의 긴 변이 최소 512px 이상인지 확인하세요.
  • 투명 패딩을 잘라내어 보이는 마크가 이미지를 채우도록 하세요. 코드는 이미지 박스의 크기를 조정하며, 잉크 자체의 크기를 조정하지 않습니다.
  • SVG: 긴 변이 약 1720px인 PNG로 래스터화하고(Headless Chrome 스크린샷, 또는 rsvg-convert -w 1720), 알파 채널을 유지한 후 data-logo-src가 이를 가리키도록 하세요. 로고를 다시 그리거나 색상을 변경하지 마세요.
  • 브랜드 로고가 결합된 락업 이미지(마크와 텍스트가 결합)인 경우 깔끔하게 분할할 수 없습니다. 전체 락업을 마크로 사용하고, data-wordmark=""로 설정한 후 워드마크 와이프를 건너뛰세요(워드마크 클립을 항상 숨김으로 설정). 그러면 마크가 왼쪽이 아닌 중앙에 도킹됩니다.

빌드 워크플로우

  1. 스캐폴드: npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills를 실행한 후, 해당 디렉토리의 index.html을 이 스킬의 template/index.html로 교체하고 template/js/, template/assets/logo.png를 복사하세요(브랜드 마크로 덮어씁니다).
  2. 런타임을 벤더링하여 렌더링이 네트워크에 접근하지 않도록 합니다. 임시 디렉토리(다른 프로젝트 내부가 아닌, npm i가 가장 가까운 package.json까지 올라가므로)에서 npm i [email protected] [email protected] @fontsource-variable/inter를 실행한 후, 다음 파일들을 프로젝트로 복사하세요:
    • gsap/dist/gsap.min.js를 vendor/gsap.min.js로
    • three/build/three.module.js와 three/build/three.core.js를 vendor/three/build/로
    • three/examples/jsm/environments/RoomEnvironment.js를 vendor/three/examples/jsm/environments/로
    • @fontsource-variable/inter/files/inter-latin-wght-normal.woff2를 assets/fonts/로
  3. index.html의 #root에 데이터 속성을 사용하여 브랜딩합니다: data-logo-src, data-wordmark, data-ink, data-fields (세 개의 16진수 색상). 필드는 악센트에서 채도를 유지하고 다른 곳에서는 부드럽게 유지하세요. 구슬 중심 뒤의 필드를 어둡고 평평하게 만들지 마세요.
  4. 린트 및 확인: npx --yes hyperframes lint 후 npx --yes hyperframes check를 실행합니다. 둘 다 깨끗해야 합니다.
  5. 프레임 검토(아래 참조). 조정. 반복.
  6. 렌더링: npx --yes hyperframes render --workers 2 --output final.mp4. 프로브: ffprobe가 h264, 1920x1080, 30fps, 예상 지속 시간을 보고해야 합니다.

모션 규칙 (형식을 작동하게 만드는 요소)

  • 읽을 수 없지만 보이지 않지는 않음. 팝 전까지 시청자는 마크의 색상과 왜곡된 형태를 보아야 하며, 결코 읽을 수 없어야 합니다. 프레임에서 로고가 식별 가능하게 보이면 thickness / 변위 진폭 / 회전을 높이세요. 구슬이 마크의 흔적 없이 평평한 덩어리라면 낮추세요.
  • 마크는 유리 뒤, 불투명 패스에 위치. 팝 전 평면은 alphaTest(불투명 큐)를 사용하여 Three.js의 투과 패스가 이를 굴절시킬 수 있도록 합니다. 일반적인 transparent: true 평면은 굴절되지 않습니다. "공개된" 복사본은 투명하며 쉘이 붕괴된 후에만 교체됩니다.
  • 단계 순서 (js/liquid-reveal.js 상단의 모든 상수 T): 설정(근접 크롭에서 전체 구슬, 0.7초) 후 액체 퍼포먼스, 압력 축적(구슬이 더 넓고 납작해지며, 마크가 1.00에서 1.06으로 팽창), 쉼표(총 0.4초 정지: 카메라, 마크, 구슬 및 셰이더 클록이 멈춤), 파열(쉘이 0.2초 동안 power-4 이즈인으로 붕괴, 물방울이 방사형으로 발사), 도킹(마크가 반동한 후 잠금 위치로 슬라이드하는 동안 워드마크가 뒤에서 나타남), 정지.
  • 정지가 핵심입니다. 팝 전 0.4초 정지가 파열을 실감나게 만듭니다. 어디에도 유휴 호흡, 부동 또는 루핑 글로우가 없어야 합니다.
  • 셰이더 클록은 제한됨. 노이즈 시간은 지정된 창에서만 진행되며 쉼표와 도킹 후에는 멈춥니다.
  • 워드마크는 마크에서 나타나며, 절대 갑자기 나타나지 않음. 클립 왼쪽 가장자리는 마크의 오른쪽 가장자리를 추적하므로 텍스트가 도킹 중간에 마크에 의해 겹쳐지지 않습니다.
  • 물방울: 황금각 고정 레이아웃(Math.random 없음), 방사형 발사, 하나의 중력 항, 그 후 최종 프레임을 깨끗하게 유지하기 위해 축소되어 사라짐.
  • 정지된 락업으로 종료. 마크와 워드마크가 똑바로 서서 쌍으로 중앙에 위치하며, 페이드 아웃 없음. 더 긴 비디오에 삽입될 인트로인 경우 페이드 대신 정지 시간을 줄이세요.
  • 결정론: 모든 것은 hf-seek 시간으로부터 계산됩니다. requestAnimationFrame, Date.now, Math.random 없음. 유일한 DOM 측정은 워드마크 너비로, 로드 시 한 번만 수행됩니다(제공된 폰트로 canvas measureText 사용).

조정 노브

원하는 것변경 사항
더 길거나 짧게T 상수와 #root의 data-duration, 두 .clip 요소의 data-duration (동일하게 유지)
더 추상적인 구슬thickness (3.2) 또는 변위 진폭 (0.15) 증가; 가독성을 위해 감소
젤리 vs. 물방울 모양liquidMaterial()의 dispersion, attenuationColor
더 크거나 작은 락업L.markPx, L.fontPx, L.gap
더 차분한 배경배경 셰이더에서 세 개의 * 0.50 / 0.80 / 0.35 필드 가중치 낮춤

워드마크를 아트워크로

브랜드가 워드마크 SVG/PNG를 제공하는 경우, #wordmark 텍스트를 동일한 위치 및 너비 로직을 가진 <img>로 교체하세요: 종횡비를 측정하고 높이를 L.fontPx * 0.8로 설정한 후 동일한 clip-path 로직을 유지하세요. 양식화된 워드마크를 대체 폰트로 다시 입력하지 마세요.

검증

  • lint와 check가 깨끗해야 함(린트 오류는 레이아웃 감사를 자동으로 비활성화함).
  • 프레임을 추출하여 확인: npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5를 실행하고 snapshots/contact-sheet.jpg를 열거나, 렌더링에서 ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png를 실행하세요. 확인 사항: (1) 초기 프레임에서 마크를 읽을 수 없는 구슬이 보여야 함, (2) 팝 직후 프레임에 마크와 겹치는 워드마크 텍스트가 없어야 함, (3) 도킹 중간 텍스트가 마크 가장자리로 잘려야 함, (4) 최종 프레임에 선명한 마크와 워드마크가 중앙에 있고, 물방울이나 잘린 글리프가 없어야 함.
  • 일반적인 실패: 빈 캔버스(importmap 경로가 잘못되었거나 WebGL three.core.js가 복사되지 않음), 워드마크가 중앙에서 벗어남(측정 전에 폰트가 로드되지 않음), 흰색 박스가 있는 로고(불투명 PNG).

전달

final.mp4와 프로젝트 폴더(index.html, js/, assets/, vendor/)를 전달하여 data-* 속성 편집을 통해 리브랜딩할 수 있도록 합니다. 오디오는 선택 사항입니다. 파열 시간 T.pop에 짧은 팝 SFX가 필요한 유일한 사운드입니다. media-use 스킬을 통해 상업적으로 라이선스된 결과물로 사운드를 확보하거나, 그렇지 않으면 무음으로 전달하세요.

Individual skills in this repo

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

SingleGrain-Team/video-skills

Make a 30-45 second launch film for a product by staging it inside one persistent, neutral chat window. A user types a request, the assistant answers and calls the product as a connected tool, a progress card runs, a follow-up triggers a second tool action, and the result lands as a count-up headline number before closing on the logo, tagline and call to action. Use when you need a launch, feature or integration announcement video for something that plugs into AI assistants (a skill, MCP server, plugin, connector, CLI). Delivers a rendered 1920x1080 MP4 plus an editable single-file HyperFrames project.

SingleGrain-Team/video-skills

Build a motion graphic where a screen recording plays in a large frame beside a checklist, and each checklist item ticks off at the exact moment that step happens in the recording, ending with every item checked and a short hold. Use when someone has a screen recording (product walkthrough, tutorial, onboarding, install demo) plus a list of steps with timestamps and wants a "watch the steps get done" film. Input is a recording, step labels with timestamps, a title and an optional palette; output is a 1920x1080 H.264 MP4 and the editable HyperFrames project.

SingleGrain-Team/video-skills

Build a 15-20 second product launch film that shows the product's real screen on a laptop built from plain CSS (no 3D model, no generation model) in a dark studio, scrolls the page, zooms into the interface for one key action such as typing a search, and resolves to the logo lockup. Use when someone has a full-page screenshot or screen recording of their product, one action worth showing, and a logo, and wants a short silent-friendly launch teaser rendered as a 1920x1080 MP4 with an editable HyperFrames project.

SingleGrain-Team/video-skills

Make a 20-30 second launch film for a product that is not tied to one interface, such as a CLI, package, plugin or agent skill. The identical prompt or command is typed into four visually different surfaces in turn (a wide terminal, a tall chat card, a floating palette, an editor cell), the film then hard-cuts into a fast reel of real outputs on a beat or fixed tempo grid, and it closes on the command in a large pill. Delivered as a rendered 1920x1080 MP4 plus the editable HyperFrames project. Music is optional - with a track the cuts land on detected beats, without one they land on a 120 bpm grid.

SingleGrain-Team/video-skills

Make a roughly 30-second film that explains a code change (a pull request, release or uncommitted diff) to people who will never read the diff. It opens by showing the real diff scrolling past too fast to follow, cuts to a plain-language summary, fires four capability beats each pinned to a real code snippet, and closes on how to get it (install command and URL). Delivered as a 1920x1080 H.264 MP4 plus the editable HyperFrames project. Use when asked to turn a PR, changelog or release into a launch or explainer video.

SingleGrain-Team/video-skills

Render a 5-6 second motion graphic in which an oversized condensed headline (2-4 words) punches in behind a presenter, using a background-removed cutout of the presenter layered on top of the lettering. A hard cut then removes the presenter while the same headline holds the exact same size and position, and a short supporting line appears for a reading hold. Use it for talking-head intros, chapter openers, launch announcements and social hooks when you have one presenter clip, a headline, a supporting line and a palette. Built on HyperFrames; delivers a 1920x1080 H.264 MP4 plus the editable project.

SingleGrain-Team/video-skills

Builds a 10-14 second product sting out of a short run of UI moments (an entry screen, a single counting metric, a navigation list, one click that opens a menu, then an endcard) cut together so every cut carries the previous motion forward and the piece reads as one continuous camera move. Delivered as a 1920x1080 H.264 MP4 plus an editable single-file HyperFrames project. Use it for app launches, feature teasers, social bumpers and site intros when you have a product's logo, a couple of screenshots, one headline number and its real nav labels, and want polished UI motion without narration.

관련 스킬