HyperFrames의 명령줄 퀵 레퍼런스 스킬: 프로젝트 생성, 검사, 프레임 확인, 타임라인 수정, 미리보기, 로컬 또는 클라우드 렌더링, 게시, 이력 조회 등 작업별 명령을 나열하며, 에이전트가 JSON 출력을 읽고 빌드 및 렌더링 실패를 처리하는 방법을 안내합니다.
skills.sh 설치 횟수 1285014(+20521 / 24h)
보안 감사: 위험 경고 있음
- 서드파티 패키지(npx / pip 등)를 설치하거나 실행하므로 명령어 실행에 해당함
- 사용 데이터(원격 측정)를 보고함
- 감사 범위: GitHub heygen-com/hyperframes/skills/hyperframes-cli/SKILL.md(SKILL.md 텍스트만 스캔)
이유
- 어제 소개한 hyperframes 메인 스킬과의 역할 분담: 메인 스킬은 합성 작성 방법을 다루고, 이 스킬은 명령어만 다룸. 고정된 워크플로우는 lint → check --json으로 모든 오류 수정 → snapshot으로 PNG 확인 → preview로 사람이 확인한 후 render 실행
- 타임라인 편집은 Studio와 동일한 형식: timeline move / trim / split 등은 먼저 --plan으로 미리보며, 각 쓰기 작업에는 되돌리기(undo) 가능한 영수증이 남음. 여러 수정 사항은 JSON으로 작성해 timeline apply로 한 번에 실행 가능
- 렌더링 위치는 필요에 따라 선택: 로컬, 재현 가능한 컨테이너인 --docker, 변수 기반 일괄 처리, HeyGen이 호스팅하는 클라우드 렌더링, 또는 자체 AWS Lambda / GCP Cloud Run
- skills.sh 24시간 내 설치 횟수 20521로 이번 호에 소개된 항목 중 가장 높으며, 누적 1285014임. 동일 저장소에는 6개의 다른 스킬도 순위권에 있음(이는 관심도를 나타냄)
사용법
- npx skills add https://github.com/heygen-com/hyperframes --skill hyperframes-cli로 설치하며, 일반적으로 hyperframes 메인 스킬과 함께 설치함
- Node.js 22+ 및 FFmpeg가 필요함. 명령어는 일관되게 npx hyperframes <명령> 형식을 사용하며, 대부분 --json을 지원하고 실패 시 Fix 라인을 출력함
- 클라우드 렌더링을 사용하려면 먼저 npx hyperframes auth login으로 HeyGen 계정에 로그인해야 하며, 크레딧 기반으로 과금됨
리스크
- 감사에서 지적된 원격 측정(telemetry)은 사실임: 작성자는 모든 렌더링 성공 후 feedback을 실행해 점수를 제출하고, 불가능한 요구 사항이 있을 경우에도 보고서를 제출하도록 요구함(원격 측정을 비활성화하거나 사용자가 거부하지 않는 한). 작성자는 피드백이 공개 채널로 전송되며, 절대 경로와 머신 식별자를 제거하도록 요구한다고 밝힘
- 감사에서 지적된 npx 실행은 용도와 일치함. 최초 실행 시 npm에서 CLI를 다운로드함
- capture <url>은 외부 웹사이트를 스크랩함. cloud render는 전체 프로젝트를 패키징하여 HeyGen으로 업로드함