Communitygithub.com

ReelStyles 설정

사용자의 AI 에이전트를 위해 이 컴퓨터에 ReelStyles를 설정합니다. Node.js 22+, ffmpeg, git 및 Chrome(HyperFrames용)을 확인 및 설치하고, 사용자가 보유한 에이전트(Claude Code, Codex, Cursor, Roo Code, Cline, Gemini CLI, GitHub Copilot, Windsurf)에 ReelStyles 스킬을 연결한 후 5초 테스트 영상을 렌더링합니다.

ReelStyles 설정란 무엇인가요?

ReelStyles 설정 스킬은 사용자의 개발 환경에서 AI 에이전트가 ReelStyles 비디오 생성 기능을 사용할 수 있도록 준비하는 작업을 자동화합니다. 사용자가 "ReelStyles 설정" 또는 "ReelStyles 설치"와 같은 명령을 내리면, 이 스킬은 먼저 운영 체제(macOS, Linux, Windows WSL, Git Bash)를 감지하고 적절한 셸 스크립트(`setup.sh` 또는 `setup.ps1`)를 선택합니다. 그런 다음 Node.js 22+, ffmpeg, git, Chrome과 같은 필수 도구가 설치되어 있는지 확인하고, 누락된 항목이 있으면 사용자 승인 하에 패키지 관리자(wget, Homebrew, apt, dnf, fnm)를 통해 설치합니다. 이후 감지된 모든 AI 에이전트(Claude Code, Codex, Cursor, Roo Code, Cline, Gemini CLI, GitHub Copilot, Windsurf)에 ReelStyles 스킬 경로를 자동으로 연결하여 각 에이전트가 `skills/reelstyles/STYLES.md`에 정의된 다양한 스타일로 비디오를 생성할 수 있게 합니다. 마지막으로 5초 테스트 영상을 렌더링하여 설정이 올바르게 완료되었는지 확인합니다. 모든 작업은 사용자 동의를 중시하며, HyperFrames 원격 측정은 비활성화되어 데이터가 외부로 전송되지 않습니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓Windsurf
npx skills add https://github.com/reelstyles/reelstyles-free/tree/main/skills/reelstyles-setup

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

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

문서

ReelStyles 설정은(는) 무엇을 하나요?

스크립트는 ReelStyles 저장소 루트(이 파일보다 두 폴더 위)의 setup/ 디렉토리에 있습니다: setup/setup.sh (macOS, Linux, WSL, Git Bash) 및 setup/setup.ps1 (Windows PowerShell). 두 스크립트는 동일한 명령을 받습니다. 아래에서 SETUP은 다음을 의미합니다:

  • macOS / Linux / WSL / Git Bash: bash <repo>/setup/setup.sh
  • Windows PowerShell: powershell -ExecutionPolicy Bypass -File <repo>\setup\setup.ps1

사용자의 프로젝트 폴더(에이전트 연결을 원하는 폴더)에서 명령을 실행하세요. ReelStyles 저장소 내부에서 실행하지 마세요. 단, 해당 폴더가 사용자가 사용하는 유일한 폴더인 경우는 예외입니다.

  1. 시스템 감지. 운영 체제(Windows, macOS, Linux, WSL)를 확인하고 일치하는 스크립트를 선택합니다. Windows에서는 Git Bash나 WSL에 있지 않은 한 setup.ps1을 선호합니다.
  2. 확인. SETUP check를 실행합니다. Node.js ≥ 22, ffmpeg + ffprobe, git, 여유 디스크 공간 및 HyperFrames용 Chrome을 나열하고, 필수 항목이 누락된 경우 0이 아닌 종료 코드를 반환합니다. READY가 출력되면 4단계로 이동합니다.
  3. 사용자 동의를 얻어 누락된 항목 설치.
    • SETUP install --dry-run을 실행합니다. 누락된 도구별로 실행할 정확한 명령(wget, Homebrew, apt 또는 dnf, fnm, nvm 또는 공식 nvm 설치 프로그램을 통한 Node)을 출력합니다.
    • 사용자에게 모든 명령을 보여주고 어떤 명령을 실행할지 물어보세요. 사용자가 동의하지 않은 것은 절대 설치하지 말고, 명령이 sudo를 사용하는 경우 명확히 알리세요.
    • 사용자가 동의한 도구만 사용하여 SETUP install --yes <tool> [<tool>...]을 실행합니다(또는 사용자가 직접 SETUP install을 실행하도록 합니다: 도구별로 확인합니다). 명령에 비밀번호가 필요한 경우 사용자에게 자신의 터미널에서 실행하도록 요청하세요.
    • 방금 설치한 Node나 git은 PATH에 추가되기 전에 새 터미널이 필요할 수 있습니다. 그런 다음 SETUP check를 다시 실행하여 READY가 출력될 때까지 반복합니다.
  4. 에이전트 연결. SETUP wire list를 실행하여 감지된 에이전트를 확인하고 사용자에게 알린 후, SETUP wire auto(또는 사용자가 지정한 에이전트에 대해 SETUP wire <agent>: claude codex cursor roo cline gemini copilot windsurf)를 실행합니다. 프로젝트에 짧은 포인터 파일(예: .cursor/rules/reelstyles.mdc, .roo/rules/reelstyles.md, AGENTS.md 블록)을 작성하여 에이전트에 ReelStyles 스킬의 위치를 알려줍니다. 키트를 복사하지 않습니다. 사용자가 모든 프로젝트에 적용하려면 --global을 추가하세요. 플러그인을 설치한 Claude Code 사용자는 연결이 필요 없습니다.
  5. 스모크 테스트. SETUP test를 실행합니다. 5초 테스트 영상을 렌더링하고 mp4 경로와 렌더링 시간을 출력합니다. 둘 다 사용자에게 보고하세요. 실패하면 SETUP check를 실행하고 나열된 항목을 수정한 후 다시 시도하세요.
  6. 완료 메시지: "ReelStyles가 준비되었습니다: STYLES.md(skills/reelstyles/STYLES.md)에서 원하는 스타일로 비디오를 요청하세요."

참고 사항

  • 여기서 어떤 데이터도 외부로 전송되지 않습니다: HyperFrames 원격 측정은 스크립트에 의해 비활성화됩니다. 첫 번째 실행은 HyperFrames npm 패키지와 헤드리스 Chrome을 다운로드합니다.
  • 스크립트는 다시 실행해도 안전합니다. 이미 완료된 작업은 건너뜁니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬