Communitygithub.com

bassam1998new-ops/hyperframes-students

떠 있는 책상 확대 스타일(style card floating-desk-zoom)의 동영상을 제작합니다. 실제 앱 창이 따뜻한 종이 위에 카드처럼 떠 있고, 가상 카메라가 액션에 맞춰 하드 컷인/아웃되며 타이핑을 따라 움직입니다.

hyperframes-students란 무엇인가요?

이 스킬은 실제 OBS 화면 녹화와 음성 해설을 바탕으로, 마치 종이 책상 위에 앱 창이 카드처럼 떠 있는 듯한 시각적 스타일(Floating Desk Zoom)의 동영상을 제작하는 AI 에이전트(Claude Code 등)를 위한 도구입니다. 주로 빌드 시연, 빠른 튜토리얼, AI 뉴스 쇼케이스에 사용되며, 아랍어 또는 영어, 9:16 세로형 릴스에 최적화되어 있습니다. `vid desk` 명령어를 통해 데스크탑 녹화본을 자르고, 카드와 샷을 정의하는 JSON을 편집한 후 최종 HTML을 빌드합니다. 카메라는 하드 컷 인 → 2.5% 선형 드리프트 유지 → 1.2~1.4초 글라이드 아웃의 움직임 패턴을 따르며, 절대 `<video>` 자체를 애니메이션하지 않고 `#fd-cam`과 `#fd-drift`만 조작합니다. 데스크 색상(기본 #E9E4DB), 그림자, 딤 처리 등은 브랜드 파일에서 가져오며, 마크다운 린트, 스냅샷, 심사 명령어로 품질을 검증합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bassam1998new-ops/hyperframes-students/tree/HEAD/.claude/skills/style-floating-desk-zoom

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

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

문서

스타일: 떠 있는 책상 확대 (Floating Desk Zoom)

차분하고 프리미엄한 제품 데모: 실제 앱 창이 부드러운 책상 위에 카드처럼 떠 있고, 카메라는 변경 사항에 가까이 컷인되었다가 천천히 글라이드 아웃됩니다. 실제 화면 녹화로만 제작되며, 생성된 것은 절대 사용하지 않습니다. 카드: video-projects/_library/styles/floating-desk-zoom/style.md — 승인됨 2026-10-02.

먼저 확인 (스타일 폴더 내): frames/01-wide.png (공개 저장소에 없음) · frames/04-punch-in.png (공개 저장소에 없음) · frames/02-glide-dim.png (공개 저장소에 없음) (또한 frames/03-card.png (공개 저장소에 없음)).

0. 먼저 카드 적용하기

node tools/vid.mjs style apply floating-desk-zoom <project> [--mode calm|punchy]
node tools/vid.mjs desk help

1. 색상 = 역할 (브랜드가 16진수 색상을 채움)

스타일 = 품질, 구조, 움직임. 따뜻한 종이는 기준점입니다. 브랜드에 자체 캔버스가 있을 때 교체하세요.

역할설정 위치brand/<name>.md 출처
책상 / 종이director/desk.json의 look.bg (기본 #E9E4DB)canvas (밝은 브랜드); 부드럽고 밝게 유지
카드 그림자look.shadow (따뜻한 갈색, 두 겹)캔버스에서 색조를 따온 그림자, 절대 단색 검정 아님
사용하지 않는 창 딤look.dim (0.55, 0 = 꺼짐)없음 — 회색, 브랜드 색상 아님
상단 제목 / 자막책상 위 별도 레이어text-strong (종이에 잉크), accent = 기본색, 한 단어만
앱 자체 색상이 나머지를 담당합니다. 책상에 추가 악센트 없음.

2. 제작하기

  • 도구는 vid desk (tools/vid/desk.mjs):
    node tools/vid.mjs desk init <project> <recording.mp4> [--from s] [--to s]   # 데스크탑 자르기 → assets/screen.mp4 + assets/voice.m4a, 스캔 후 director/desk.json 작성
    # director/desk.json 편집: cards [{id, rect}], shots [{at, card, focus, move:"cut"|"glide", dur, pan}], look {…}
    node tools/vid.mjs desk build <project>                                      # → compositions/floating-desk.html; 출력된 host <div>를 index.html에 붙여넣기
    
    vid desk scan <video> 는 화면이 변경되는 위치(타이핑, 패널, 스크롤)를 보여줍니다. 해당 위치에 punch-in을 배치하세요. 소유자의 OBS 녹화본은 2160×3840이며 데스크탑이 중간 밴드에 있습니다. init이 자릅니다.
  • 자체 카메라 변형 (종이 느낌, 더 많은 제어): 이전 프로젝트(비공개) + build_cut_hd.py(punch-in이 선명하게 유지되도록 풀 해상도 두 번째 컷).
  • 레이아웃 9:16 (1080×1920): 와이드 = 카드 ~너비의 90%, y 900에 중앙 정렬. 펀치된 카드는 전체 너비를 유지하지만 y 420–1240 내부에 있어 키커 텍스트와 자막이 종이 위에 위치합니다. 카드가 와이드일 때 텍스트는 y 330–1470 영역 밖에 유지하세요.
  • 레이아웃 16:9: 아직 제작되지 않음.
  • 카메라 (움직임 토큰): 컷 인(하드 컷, 소스 픽셀당 최대 1.6 출력 픽셀) → 2.5% 선형 푸시(#fd-drift)로 유지, 타이핑 따라 선택적 팬(sine.inOut) → 글라이드 아웃 1.2–1.4초 power3.inOut → 옆으로 슬라이드하여 다음 창으로 이동. 3–6초마다 한 번 움직임, 두 움직임 사이 1.5초 이상 간격 확보.
  • 절대 <video>를 애니메이션하지 마십시오 — 오직 #fd-cam(이동/확대)과 #fd-drift(푸시)만 조작합니다.
  • 텍스트: 내장 텍스트 없음. 제목, 자막, 카운트업은 책상 위 별도 레이어에 배치합니다(아랍어: IBM Plex Sans Arabic, 종이에 잉크).
  • 전환: 카메라 움직임만 사용; 와이프, 플래시 없음.
  • 모드: calm = vid desk가 제작하는 그대로(드리프트 2.5%, 글라이드 1.2–1.4초, SFX 없음) · punchy (미테스트) = 글라이드 0.7초 expo.inOut, 드리프트 4%, punch-in에 틱 효과음.
  • 사운드: 음성 −14 LUFS, _library/assets/music (공개 저장소에 없음)에서 가져온 부드럽고 최소한의 배경 음악 약 −23 LUFS, 음성에 맞춰 덕킹. 선택적으로 글라이드 시 부드러운 우쉬 효과음(_library/assets/sfx/el/whoosh-slow.mp3 (공개 저장소에 없음)). 음악을 생성하지 마십시오.

3. 소유자가 보기 전 확인 사항

  1. 프로젝트 내에서 npx hyperframes lint 실행 — 오류 0개 (카드 2개 이상일 때 duplicate_media_discovery_risk 경고는 무해).
  2. npx hyperframes snapshot --at <각 샷 시간> — 모든 프레임 읽기: 텍스트 선명, 브라우저 아래 검은 띠 없음.
  3. npx hyperframes render --quality draft → node tools/vid.mjs judge <draft.mp4> → sheet.jpg와 safe-sheet.jpg 읽기.
  4. 안전 영역 x 60–960, y 220–1500 · 아랍어 자막은 연결되고 오른쪽에서 왼쪽으로, 글자 단위로 나누지 말고, <html>에 dir="rtl" 사용 금지.
  5. 스타일 확인: desk build가 최대 확대 제한에 걸린 샷을 나열합니다. 수정하세요. 모든 punch-in에서 개인 데이터(키, 이메일, 고객 이름) 확인 후 블러 처리 또는 잘라내기; 종이가 화면에 나타나면 자막을 잉크 스타일로 전환.

준수 / 금지 사항

  • 준수: 큰 앱 글꼴(125–150%)과 단계 사이 1–2초 일시 정지가 있는 녹화본 요청; 그가 명명한 정확한 단어(모델 레이블, 가격 토스트, 프롬프트)에 punch-in; 밝은 UI에는 잉크, 어두운 UI에는 종이로 링 처리.
  • 금지: 나란히 비교 시 창 딤 처리(소유자: "딤 제거"); 1.6배 이상 확대; 1.5초 미만 간격으로 움직임 겹치기; 화면에 이미 표시된 내용을 반복하는 칩 유지; 개인 데이터 표시.

작업 후: node tools/vid.mjs style comment floating-desk-zoom "<잘된 점 또는 안된 점>".

Individual skills in this repo

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

bassam1998new-ops/hyperframes-students

Make a new video with a beginner, start to finish — a few easy questions, pick a look from this repo's styles, build it with HyperFrames, check the frames, render and show it. Use when the student says "new video", "make a video", "اعمل فيديو", "عايز فيديو", "reel", "animation", or asks how to start a video. Hands the technical HyperFrames rules to the official hyperframes skills.

bassam1998new-ops/hyperframes-students

First-time setup for the HyperFrames student studio. Checks the computer (Git, Node.js, FFmpeg, the render browser), explains in plain words what is missing, recommends what to install, asks before installing anything, then makes a 3-second test video to prove it all works. Use when the student says "setup", "install", "اعمل setup", "نزّل البرامج", "it doesn't work", "command not found", when node_modules is missing, or when `npx hyperframes doctor` shows a red item. Safe to run again any time — it skips what is already done.

bassam1998new-ops/hyperframes-students

Build a video in the Amber Grid Newsroom look (style card amber-grid-newsroom) — a hot "breaking news" desk: near-black grid field, the real screen recording in a framed window with instant reframes, an English title over an Arabic title line, and karaoke captions where the spoken word turns hot. Use when the director picked this card, or the owner says "make it in the amber newsroom style", "news desk", "breaking news look", "زي ريل opus 5.5", "ستايل الأخبار", or the video is AI news or a build show-off cut from his OBS screen recording with an Egyptian Arabic voice-over. 9:16 reels. Not for lecture clips or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Cream Caret Type look (style card cream-caret-type) — Arabic words typed with a coloured caret on a flat two-colour page (night and paper that swap on hard cuts), select-highlight → delete → retype, a flat profile silhouette, one coloured dot that match-cuts into a flat vector eye, a zoom-through the iris, a fixed noun with a bold verb swapping every 16 frames, a pixel-art icon on the sign-off and a monogram end card — one sound per event, silence between. Use when the director picked this card, or the owner says "the typing intro", "caret type", "cream caret", "زي فيديو الكتابة", "الكلام اللي بيتكتب", "intro بالكتابة", or the video is a channel / "who am I" intro, a course or service intro hook, a short opener before a talking head, a word-play promise line or a bumper. 9:16 only, Arabic-first. Not for talking heads the whole time, screen-recording proof, data-heavy explainers or full spoken subtitles. DRAFT — untested.

bassam1998new-ops/hyperframes-students

Build a video in the Hatch Cosmos look (style card hatch-cosmos) — a hand-drawn pencil-hatched world on one canvas, a block mascot (or a pair) that walks, looks, blinks and does ^ ^ eyes, a dive through its eye into a hatched galaxy of nebula blobs, tilted rings and needle stars. Use when the director picked this card, or the owner says "hatched", "hatch cosmos", "pencil cosmos", "the galaxy video style", "the mascot dive", "زي فيديو المجرة", "الستايل المرسوم بالقلم", "الكائن اللي بيدخل في عينه", or the video is a music-led show-off/teaser, a concept intro with a mascot, a "journey inside" beat or a channel bumper. 9:16 and 16:9 both built. Not for talking heads, real screen-recording proof, data-heavy explainers or photographic looks.

bassam1998new-ops/hyperframes-students

Build a video in the Horizon Prompt One-shot look (style card horizon-prompt-oneshot) — one continuous camera on a near-black stage lit by a soft planet-horizon glow; a glass app bar, a cursor and a prompt box morph into each other, a prompt is typed, the send button grows into a tile that blooms into a full-frame result, then a light wipe to a logo end card, every beat hit-synced to a UI sound. Use when the director picked this card, or the owner says "horizon prompt", "the prompt one-shot", "the ChatGPT-style promo", "زي فيديو البرومبت", "الكيرسر اللي بيكتب البرومبت", or the video is an AI tool show-off / prompt-to-result demo, a course or service promo opener, a launch teaser or a channel bumper. Not for talking heads, real screen-recording proof, data-heavy explainers or long tutorials. DRAFT — untested.

bassam1998new-ops/hyperframes-students

Remix 2+ existing style cards of the Hyperframes video workspace into one NEW draft style card, layer by layer (palette roles, type, texture, grade, camera, light, edit rhythm, transitions, motion, sound, prompt parts), then let the owner pick the skills for the video and start the director. Use when the owner says "hybrid style", "remix styles", "mix two styles", "combine styles", "اعمل هايبرد", "ادمج الستايلين", or ticks cards and presses "Remix these" on the Styles board.

bassam1998new-ops/hyperframes-students

Build a video in the Midnight Kinetic Type look (style card midnight-kinetic-type) — clean motion type on a flat dark field, word-by-word mask rises, one accent word that lands alone, icon strokes that draw on, and hard cuts on the music's beat grid. Use when the director picked this card, or the owner says "make it in the kinetic type style", "midnight type", "like an earlier project", "تايبوجرافي متحركة", or the video is a direct offer, proof / results reel or AI news told with type, music and SFX (no face, no footage). Arabic (Cairo, per-word) and English (Inter) versions; 9:16 reels. Not for lecture clips or quick tutorials.

bassam1998new-ops/hyperframes-students

Build a video in the Midnight Screen Desk look (style card midnight-screen-desk) — a calm, organised news desk in three fixed zones: an Arabic info card on top, the real screen recording in a glowing band with punch-ins in the middle, and word-by-word captions (dim → bright) below. Use when the director picked this card, or the owner says "make it in the screen desk style", "three zones", "like the AI releases reel", "كارت فوق والشاشة في النص", or the video is AI news, a build show-off or a quick tutorial cut from his screen recording with an Egyptian Arabic voice-over. 9:16 reels. Not for lecture clips or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Mint Lecture Room look (style card mint-lecture-room) — a calm classroom cut of a real lesson: one long take with slow zooms that follow the point, a topic lower third, a quiz card that asks, counts down think-time and then answers, and karaoke captions that light the current word. Use when the director picked this card, or the owner says "make it in the lecture room style", "lecture clip", "course cut", "quiz card", "قص من المحاضرة", "سؤال وجواب", or the video is a lecture clip or quick tutorial cut from his AI course recordings (Egyptian Arabic). 9:16 reels. Not for AI news or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Neon Node Explainer look (style card neon-node-explainer) — a plain stage, one headline per spoken sentence, and one small glowing diagram (tiles, lines, packets, checks, terminal, tool list) that builds itself part by part. Use when the director picked this card, or the owner says "make it in the neon node style", "node explainer", "API vs MCP style", "اعمله زي فيديو الـ MCP", or the video is an AI explainer, concept explainer, quick tutorial or AI news with a voice-over and no face. Arabic headlines + English mono labels; 9:16 and 16:9 both built. Not for talking heads, warm stories, real screen-recording demos or music-only hype reels.

bassam1998new-ops/hyperframes-students

Build a video in the Swiss Motion Reel look (style card swiss-motion-reel) — a Swiss-grid "instrument panel" with a constant thin HUD, flat 2-colour blocks, word slams, shape match-cuts and hard cuts on a 128 BPM beat. Use when the director picked this card, or the owner says "make it in the Swiss style", "motion reel", "like the motion designer reel", "HUD reel", "ستايل سويسري", or the video is a brand sizzle, product intro, "what we do" reel, launch teaser or any no-person, graphics-only, music-led video. Latin display type with Arabic in a clean geometric sans; built and tested in 16:9, 9:16 still to build. Not for talking heads, screen-recording tutorials or long voice-led explainers.

bassam1998new-ops/hyperframes-students

Build a video in the Warm Glass Face-cam look (style card warm-glass-facecam) — the presenter talks to camera while frosted-glass panels with one warm glow land exactly where he points; blur-punch text, a karaoke pill, small charts, and a shrink into a rounded picture-in-picture for the demo part. Use when the director picked this card, or the owner says "make it in the warm glass style", "glass panels over my face", "face-cam with glass cards", "PiP intro", "كروت زجاج وأنا بتكلم", or the video is a build show-off or quick tutorial with the owner on camera. Source is English 16:9; the 9:16 and Arabic versions still have to be built at the first job. Not for lecture clips or AI news.

bassam1998new-ops/hyperframes-students

Build a video in the <Style name> look (style card <slug>). Use when the director picked this style card, when the owner says "make it in the <Style name> style", "<slug>", "استايل <Style name>", or the video type is <video types from use_when>. Works for Arabic (Egyptian) and English, 9:16 reels<, and 16:9 if supported>. Not for <avoid_when>.

관련 스킬