Communitygithub.com

HyperFrames 학생 스튜디오 첫 설정

HyperFrames 학생 스튜디오의 첫 번째 설정을 도와줍니다. 컴퓨터(Git, Node.js, FFmpeg, 렌더 브라우저)를 확인하고, 빠진 항목을 설명한 뒤 설치를 권장하며, 실제로 설치하기 전에 허락을 구하고, 모든 것이 작동하는지 3초짜리 테스트 영상을 만들어 확인합니다.

HyperFrames 학생 스튜디오 첫 설정란 무엇인가요?

이 스킬은 HyperFrames 영상 제작 스튜디오를 처음 사용하는 학생이 컴퓨터 환경을 올바르게 구축할 수 있도록 돕는 Claude Code 전용 설정 도구입니다. 학생이 "setup", "install", "안 돼요", "command not found" 등과 같은 말을 하거나 `npx hyperframes doctor` 명령어에서 빨간 항목이 보일 때 이 스킬을 실행하라는 지시를 받습니다. 스킬은 Windows, macOS, Linux 세 플랫폼을 모두 지원하며, Git, Node.js 22+, npm, FFmpeg+FFprobe, 여유 디스크 공간(약 3GB)을 확인하고 부족한 항목을 설치합니다. 모든 설치는 사용자에게 먼저 허락을 구한 후 진행되며, 운영체제별로 winget(Windows), Homebrew(macOS), apt(Linux) 같은 적절한 패키지 관리자를 사용합니다. 설치가 완료되면 `npx hyperframes init`으로 빈 프로젝트를 만들고, 간단히 수정한 뒤 `npx hyperframes render`를 실행하여 3초짜리 테스트 영상을 만들어 모든 것이 정상 작동함을 증명합니다. 각 단계마다 필요한 경우 새로운 Claude Code 세션에서 계속 진행하도록 안내하며, 이미 완료된 단계는 건너뛰므로 안전하게 다시 실행할 수 있습니다.

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

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

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

문서

셋업 — 초보자 컴퓨터 준비하기

학생은 초보자입니다. 학생의 말투로, 짧은 문장으로, 한 번에 한 단계씩 이야기하세요. 확인은 직접 수행하세요. 모든 설치 전에 허락을 구하세요. 절대 학생 대신 비밀번호를 입력하지 마세요.

0. 올바른 폴더인가요?

이 작업은 스튜디오 폴더 안에서 실행되어야 합니다 (CLAUDE.md와 video-projects/_library/가 있어야 함). 다른 곳에 있다면 폴더를 찾거나 학생이 어디에 클론했는지 물어본 후 cd로 이동하세요.

1. 무엇이 있는지 확인하기

운영체제(Windows / macOS / Linux)를 파악하고 다음 명령어들을 실행하세요. 원시 출력을 보여주지 말고, 짧은 목록으로 보여주세요.

확인 항목명령어필요 여부한 줄 설명
Gitgit --version예이 스튜디오와 업데이트를 다운로드합니다
Node.js 22 이상node --version예HyperFrames를 실행합니다
npmnpm --version예Node.js와 함께 제공됩니다
FFmpeg + FFprobeffmpeg -version, ffprobe -version예프레임과 소리를 MP4로 합칩니다
여유 디스크 공간(doctor가 표시)~3 GB도구와 영상을 위해 필요합니다

다음과 같이 보여주세요:

✓ Git
✗ Node.js — 설치되지 않음 (필요: HyperFrames를 실행합니다)
✓ FFmpeg

모든 항목이 ✓라면 그렇게 말하고 3단계로 가세요.

2. 빠진 항목 설치하기 — 먼저 묻고, 하나씩

각 ✗ 항목에 대해: 그것이 무엇인지(한 줄), 무료라는 점, 추천하는 내용을 말하고 "설치할까요?"라고 물으세요. '예'라고 대답할 때까지 기다리세요.

Windows (winget은 Windows 10/11에 내장됨):

  • Node.js: winget install -e --id OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
  • FFmpeg: winget install -e --id Gyan.FFmpeg --accept-package-agreements --accept-source-agreements
  • Git: winget install -e --id Git.Git --accept-package-agreements --accept-source-agreements
  • Windows에서 "이 앱이 디바이스를 변경하도록 허용하시겠어요?" 창이 뜨면 예를 클릭하라고 안내하세요.
  • winget 자체가 없으면: https://nodejs.org (LTS 버튼), https://git-scm.com 으로 보내고 FFmpeg는 "Microsoft Store에서 앱 설치 관리자를 설치한 후 다시 시도할게요"라고 말하세요.

macOS (Homebrew 사용):

  • brew --version을 확인하세요. 없으면 학생이 직접 설치 프로그램을 실행해야 합니다. Mac 비밀번호를 묻기 때문입니다. 학생에게 말하세요: 터미널 앱을 열고, https://brew.sh 에서 명령어를 복사해 붙여넣고 Enter를 누르고, Mac 비밀번호를 입력하세요(입력 중에는 보이지 않는 것이 정상입니다). 완료되면 알려주세요.
  • 그런 다음: brew install node ffmpeg git

Linux: 비밀번호가 필요하므로 학생이 자신의 터미널에서 직접 실행합니다: sudo apt install -y git ffmpeg. Node.js 22+의 경우 https://nodejs.org 에서 LTS 설치 프로그램을 권장합니다.

무언가를 설치한 후: 새 프로그램이 이 Claude 창에 바로 보이지 않습니다. 학생에게 말하세요: "Claude Code를 완전히 종료하고, 같은 폴더에서 다시 열고 /setup을 입력하세요 — 여기서부터 계속할게요." 그런 다음 멈추고 기다리세요. (학생이 돌아오면 1단계에서 새 ✓를 확인할 것입니다.)

3. 스튜디오 자체 구성 요소 설치하기

각각의 기능과 대략적인 크기를 설명한 후 순서대로 실행하세요:

  1. npm install — 이 폴더에 HyperFrames를 다운로드합니다 (약 120MB, 약 1분 소요).
  2. npx hyperframes skills — Claude에게 공식 HyperFrames 규칙을 가르칩니다 (작은 용량). 먼저 물어보세요: 이 컴퓨터에 Claude용 스킬을 설치합니다.
  3. npx hyperframes browser ensure — 영상 제작에만 사용되는 개인 Chrome 복사본을 다운로드합니다 (~150MB). 일반 브라우저는 영향을 받지 않습니다.
  4. npx hyperframes doctor — 최종 확인. 중요한 빨간 항목만 설명하세요: Node.js, FFmpeg, FFprobe 및 Chrome이 ✓여야 합니다. 다음은 무시해도 되는 선택 사항입니다: 새 버전 사용 가능, whisper-cpp(자동 자막), MusicGen(AI 음악), Docker.

npx hyperframes skills 후: 새 스킬은 새 세션에서 로드됩니다. 학생에게 말하세요: "Claude Code를 종료하고 이 폴더에서 다시 연 다음 /setup을 입력하세요 — 테스트 영상부터 계속할게요."

4. 작동 증명: 3초짜리 테스트 영상

인터넷이 필요합니다 (애니메이션 라이브러리가 웹에서 로드됨). 명령어를 한 줄씩 실행하세요 (PowerShell에서는 &&가 작동하지 않습니다):

mkdir my-videos
cd my-videos
npx hyperframes init hello-test --example blank --resolution portrait --non-interactive
cd hello-test

blank 예제는 10초이며 "Title"이라고 표시됩니다. index.html에서: 텍스트를 학생 이름이나 "Hello"로 변경하고, data-duration="10"을 모두 3으로 설정하고, 페이드 인 효과를 추가하고(tl.fromTo("#title", { opacity: 0 }, { opacity: 1, duration: 0.6 }, 0);) window.__timelines 줄 앞에 tl.set({}, {}, 3);을 추가하세요. 그런 다음:

npx hyperframes lint
npx hyperframes render --quality draft

MP4 파일을 my-videos/hello-test/renders/에서 찾아 학생에게 위치를 알려주고 열어볼지 제안하세요. 실패하면 오류를 읽고 수정한 후 다시 시도하세요. 망가진 단계를 학생에게 넘기지 마세요.

5. 완료

짧게 말하세요:

  • "설정이 완료되었습니다. 영상은 my-videos 폴더에 저장됩니다."
  • "영상을 만들려면 /new-video를 입력하세요."
  • "다음에 사용할 때는 같은 폴더에서 Claude Code를 여세요." 사용한 전체 폴더 경로를 알려주고 방법을 설명하세요:
    • Claude 데스크톱 앱: 코드 탭 → 폴더 선택/열기 → 해당 폴더를 선택하세요.
    • 터미널: cd "<전체 경로>"를 입력한 후 claude를 실행하세요.
  • Windows에서 "Documents"는 실제로 OneDrive 안에 있을 수 있습니다 (OneDrive\Documents). 클론이 실제로 어디에 위치했는지 확인하고 정확한 경로를 알려주세요.

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

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 Floating Desk Zoom look (style card floating-desk-zoom) — real app windows float as cards on warm paper, a virtual camera hard-cuts in on the action, follows the typing and glides back out. Use when the director picked this card, or the owner says "make it in the floating desk style", "paper desk", "zoom on the screen like the launch video", "اعمله على الورق", or the video is a build show-off, quick tutorial or AI news made from his OBS screen recording with a voice-over. Arabic or English; 9:16 reels. Not for lecture clips or talking heads.

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>.

관련 스킬