Communitygithub.com

hoodini/ai-agents-skills

모든 영상을 자막이 포함된 쇼케이스로 편집합니다. 모든 언어(기본 large-v3)를 전사하고, 렌더링 전에 transcript_review.txt를 사용자에게 제공하여 오인식을 수정하도록 한 후, HyperFrames 합성으로 최종 영상을 렌더링합니다.

ai-agents-skills란 무엇인가요?

이 스킬은 HyperFrames 프레임워크 위에서 동작하는 엔드-투-엔드 자막 영상 편집 파이프라인입니다. 사용자가 영상 파일을 제공하면 자동으로 음성을 텍스트로 변환(Whisper large-v3, 히브리어 포함 모든 언어 지원)하고, transcript_review.txt 파일을 생성하여 사용자가 직접 전사 결과를 검토하고 수정할 수 있도록 합니다. 사용자가 승인하면 liquid-glass 캡션, liquid blob 배경, liquid morph 전환 효과가 포함된 HyperFrames 컴포지션을 빌드하고 최종 영상을 렌더링합니다. 16:9(YouTube/가로)와 9:16(TikTok/Instagram Reels/YouTube Shorts)을 동일한 16:9 소스에서 모두 렌더링하며, 세로 모드는 중앙에 배치된 푸티지 스트립과 블러 배경, 세로형 캡션을 사용합니다. 이 스킬은 `yuv-pilot` 오케스트레이터의 하위 스킬로, `yuv-design-system`(Neon 모드)과 함께 사용하거나 독립적으로 사용할 수 있습니다. 배경 제거 기능으로 인물 뒤에 텍스트를 배치하는 옵션도 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hoodini/ai-agents-skills/tree/HEAD/skills/video-edit

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

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

문서

비디오 편집 — 자막 쇼케이스 파이프라인

HyperFrames 기반의 엔드-투-엔드 자막 비디오 편집기입니다. 사용자가 비디오를 제공하면 전사 → 검토 → 렌더링 과정을 조율하며, 긴 렌더링 전에 항상 대본 승인을 위해 일시 중지합니다.

YUV.AI 피라미드에서 이 스킬의 위치

video-edit은 yuv-design-system, yuv-decks, yuv-viral-video, parallax-landing-page, video-to-landing-page와 함께 YUV.AI 스킬 피라미드의 중간 계층에 있습니다. 최상위 오케스트레이터인 yuv-pilot은 사용자가 자막이 있는 쇼케이스, 튜토리얼, 또는 자막이 있는 토킹헤드 편집을 원할 때 이곳으로 라우팅합니다.

이것은 yuv-viral-video의 보다 일반적인 비디오 파생 스킬입니다. 차이점은:

  • yuv-viral-video — 정해진 YUV.AI 바이럴 숏 파이프라인(MrBeast 템포, 시그니처 편집 스타일)
  • video-edit — 대본 검토 후 렌더링하는 일반 자막 편집기(히브리어 + 영어 + 모든 Whisper 언어)

YUV.AI 브랜드 자막 비디오의 경우 이 스킬을 yuv-design-system(타입/팔레트 결정을 위한 네온 모드)과 함께 사용하십시오. 일반/타사 자막 비디오의 경우 이 스킬은 단독으로 작동합니다.

호출 시점

  • 비디오 파일(mp4/mov/mkv) 경로 + "편집", "자막", "자막 추가", "릴/프로모션 제작", "동일하게 처리" 요청
  • "자막 수정 / 히브리어 맞춤법 오류 수정" — 기존 프로젝트의 검토 단계에서 다시 진입
  • 모든 자막 튜토리얼 / 토킹헤드 / 프로모션 제작

저장 위치

기본값: ~/Documents/yuv-projects/videos/<slug>/ — 렌더 결과를 찾을 수 있도록 항상 자막 비디오 프로젝트를 여기에 저장합니다. <slug>는 주제 또는 소스 파일명에서 파생된 짧은 이름입니다.

mkdir -p ~/Documents/yuv-projects/videos
cd ~/Documents/yuv-projects/videos
# 여기서 프로젝트를 초기화합니다.

최종 렌더는 ~/Documents/yuv-projects/videos/<slug>/renders/<name>_FINAL.mp4에 저장됩니다. 렌더가 끝나면 사용자에게 비디오 위치를 알려주십시오.


워크플로우 (12단계)

  1. 소스 분석 — ffprobe로 해상도, fps, 길이, 오디오 확인.

  2. 프로젝트 생성 — cd ~/Documents/yuv-projects/videos && npx hyperframes init <slug> --video <path> --non-interactive. 복사된 비디오 이름을 source.mp4로 변경.

  3. 오디오 추출 — ffmpeg -i source.mp4 -vn -ac 1 -ar 16000 audio.wav.

  4. 전사 — references/transcribe.py를 프로젝트로 복사. 기본 모델 large-v3(히브리어에 가장 좋음). CUDA는 일반적으로 Windows에서 실패(cuDNN 부재); 스크립트는 CPU int8로 폴백. 히브리어는 language="he", 영어는 language="en"으로 강제 지정; 그 외는 자동 감지.

  5. 알려진 오류 적용 — references/corrections-hebrew.md 내용을 프로젝트 루트의 corrections.json으로 복사(키 = 잘못된 토큰, 값 = 올바른 토큰).

  6. 🛑 정지 — 리뷰 서버를 시작하고 사용자가 웹앱에서 승인하도록 합니다. 먼저 알려진 오류를 적용합니다: references/make_review.py를 프로젝트로 복사하고 실행 python make_review.py. transcript.json에 corrections.json을 적용합니다.

    그런 다음 리뷰 서버를 백그라운드 작업으로 실행합니다(사용자가 브라우저에서 "승인 및 렌더"를 클릭할 때까지 차단):

    python "$HOME/.claude/skills/video-edit/references/serve_review.py" .
    # Windows: python "C:\Users\<you>\.claude\skills\video-edit\references\serve_review.py" .
    

    서버는 REVIEW_URL=http://localhost:PORT/와 같은 줄을 출력합니다. 백그라운드 작업 출력(또는 stdout 읽기)에서 URL을 가져와 사용자에게 보냅니다:

    👉 여기서 대본을 검토하세요: http://localhost:PORT/ 승인 및 렌더를 클릭하면 자동으로 계속 진행합니다.

    에이전트는 "계속" 메시지가 필요하지 않습니다 — 사용자가 버튼을 클릭하면 서버는 transcript_review.txt를 프로젝트 디렉토리에 쓰고 코드 0으로 종료합니다. 에이전트의 백그라운드 작업 알림이 실행되고 파이프라인이 8단계부터 재개됩니다.

    브라우저/서버가 없는 경우 폴백: 정적 파일로 편집기를 엽니다 (start "" "$HOME/.claude/skills/video-edit/transcript-editor/index.html"), 사용자에게 프로젝트 폴더를 선택하고 편집한 후 transcript_review.txt를 프로젝트에 저장하고 "계속"이라고 응답하도록 요청합니다. 편집기는 두 모드를 모두 지원합니다.

  7. (선택 사항) 배경 제거 — 아래 7단계 참조; 사용자 검토와 병렬로 실행 가능.

  8. 승인 후 python references/apply_review.py를 실행합니다. 편집된 줄을 다시 토큰화하고 단어 타이밍을 transcript.json에 재분배하여 캡션 동기화가 여전히 작동하도록 합니다.

  9. (선택 사항) 배경 제거 — 토킹헤드 세그먼트에 피사체 뒤 텍스트가 필요한 경우 outro.mp4(또는 intro.mp4)로 세그먼트를 추출하고 npx hyperframes remove-background <clip>.mp4 -o <name>_subject.webm --quality best를 실행합니다. 대부분의 설정에서 CPU 전용(15초 1440p 클립에 약 38분 소요).

  10. 밀집 키프레임으로 소스 재인코딩 — 멀티 워커 렌더는 성긴 키프레임에서 프리즈 현상이 발생합니다. 항상 실행:

    ffmpeg -y -i source.mp4 -c:v libx264 -preset medium -crf 18 -r 30 -g 30 -keyint_min 30 -sc_threshold 0 -pix_fmt yuv420p -movflags +faststart -c:a copy footage.mp4
    
  11. (편집된) 대본을 다시 로드하고 references/gen_body.py를 통해 본문 서브 컴포지션을 생성합니다. 생성기는 전체 compositions/components/caption-body.html을 내보내며, 에디토리얼과 매트릭스가 번갈아 나타나는 liquid-glass 캡션으로 구성되고 왼쪽 하단 중앙에 고정됩니다(오른쪽 하단 웹캠 PiP 영역을 비움).

  12. 호스트 index.html을 references/host-template.html에서 연결합니다. 레이어 순서(z-index, 트랙 인덱스 아님):

    • z0: 푸티지 .cam-bg
    • z1: liquid blob 배경(compositions/liquid-blobs.html, mix-blend-mode: screen, 전체 길이)
    • z2: 피사체 뒤 자막 패럴랙스(intro 및/또는 outro, 배경 제거 사용 시)
    • z3: 피사체 컷아웃 .cam-out / .cam-sub(일치하는 data-media-start 포함)
    • z6: 본문 캡션
    • z46: 진행 바 + 플래시 + liquid morph 전환 효과
  13. 린트 — npx hyperframes lint. 오류가 0이어야 합니다. 일반적인 수정 사항: 전환 효과 요소의 GSAP/CSS transform 충돌(xPercent/yPercent 사용 또는 CSS transform 제거); 동일 속성에 대한 중복 트윈(overwrite: "auto" 추가).

  14. 렌더 — npx hyperframes render --quality standard --fps 30 --output renders/<name>_FINAL.mp4. Standard가 적절한 전달 대상입니다. high는 렌더 시간을 약 두 배로 늘립니다. 완료 보고 전에 타임라인 전체에서 6~8개의 스팟 체크 프레임으로 확인합니다.

TikTok/Reels/Shorts용 세로(9:16) 출력

사용자가 세로/포티트/TikTok/Reels/9:16 출력을 요청할 때(16:9 소스에서):

  1. 프로젝트를 형제 폴더로 복제: cp -r project/ project-vertical/.
  2. index.html을 references/host-template-vertical.html(1080×1920 캔버스, 블러 배경과 liquid blob, 중앙에 16:9 푸티지 가로 스트립, 캡션 아래)로 교체.
  3. gen_body.py를 references/gen_body_vertical.py(중앙 정렬 캡션, 더 큰 글꼴, 더 좁은 최대 너비)로 교체하고 다시 실행하여 compositions/components/caption-body.html을 생성.
  4. 피사체 뒤 컷아웃 + 패럴랙스 서브 컴포지션을 제거(컷아웃은 16:9에 정렬되어 있음, v1에서 재정렬할 가치 없음). 세로 컴포지션은 대신 블러 소스 배경 + blob를 분위기로 사용.
  5. data-duration을 실제 비디오 길이로 업데이트. index.html의 브랜드 칩 텍스트를 업데이트(기본값 YUV.AI).
  6. 린트 + 렌더 — 동일한 명령어. 출력은 1080×1920. TikTok/IG Reels/YT Shorts에 바로 업로드.

16:9와 9:16을 한 번에 제공하려면 두 개의 렌더 명령어를 실행합니다(병렬 프로젝트). transcript_review.txt 승인은 둘 다에 적용됨 — 동일한 캡션, 두 개의 컴포지션.

중요 규칙

  • 명시적인 대본 승인 없이 최종 렌더를 절대 실행하지 마십시오. 검토 단계가 핵심입니다.
  • 히브리어: large-v3 + language="he" + direction: rtl + Rubik(700 + 900, 편집 이중 가중치 강조용).
  • 캡션 필은 항상 불투명한 어두운 배경이 필요합니다 — 밝은 텍스트만 있으면 흰색 앱 UI에서 사라집니다.
  • 캡션 필을 가로로 중앙 정렬하되 푸티지에 오른쪽 하단 웹캠 PiP가 있는 경우 중앙 x 좌표를 왼쪽으로 이동(예: left: 720px).
  • 피사체 뒤 컷아웃 클립은 반드시 data-media-start가 data-start와 일치해야 합니다(또는 클립이 추출된 경우 소스의 오프셋과 일치). 그렇지 않으면 컷아웃이 프레임 0부터 재생되어 동기화가 깨집니다.
  • remove-background webm은 원본 RGB를 유지하고 알파 마스크만 씁니다 — ffprobe는 yuv420p를 보고하여 "알파 없음"처럼 보입니다. TAG:ALPHA_MODE=1을 통해 확인하거나 단색 위에 합성하여 확인합니다.
  • 아웃트로/엔드 카드에 텍스트가 박혀 있는 경우 — 그 위에 캡션을 넣지 마십시오. 충돌합니다.

파일 참조

파일목적
transcript-editor/index.html대화형 브라우저 편집기 — 비디오 미리보기, RTL 편집, 사전 적용, 선택적 WebLLM AI 제안, transcript_review.txt 저장
references/setup.mdNode/Python/FFmpeg/faster-whisper용 사전 요구 사항 + 설치 명령어
references/transcribe.pyCPU 폴백 + 단어 타임스탬프가 있는 faster-whisper 전사
references/serve_review.py로컬 리뷰 서버 — 자동으로 편집기 로드, 사용자가 승인 및 렌더를 클릭할 때까지 차단, 그 후 transcript_review.txt를 쓰고 종료(에이전트에 신호 보냄)
references/make_review.py오류 수정 적용 + transcript_review.txt 생성(파일 모드 폴백)
references/apply_review.py편집된 리뷰 파일 파싱, 단어 타이밍 재분배, transcript.json 업데이트
references/gen_body.py캡션 본문 생성기(에디토리얼 + 매트릭스를 liquid-glass 필에 표시)
references/host-template.html16:9 호스트 컴포지션(액체 효과 + 전환 와이프 포함)
references/host-template-vertical.html9:16 호스트(1080×1920) — TikTok/Reels/Shorts 레이아웃: 블러 배경, 중앙 16:9 푸티지 스트립, 아래 캡션, 오른쪽 상단 브랜드 칩
references/gen_body_vertical.py세로용으로 조정된 캡션 본문 생성기(중앙 정렬 캡션, 더 큰 글꼴, 더 좁은 최대 너비)
references/liquid-blobs.html전체 길이로 떠다니는 blob 레이어
references/caption-parallax-outro.html피사체 뒤 캡션 템플릿(영어, 다른 언어는 복제하여 사용)
references/corrections-hebrew.md알려진 히브리어 Whisper 오인식 목록
references/transcript-review-workflow.md일시 중지/승인 단계 상세 설명

Individual skills in this repo

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

hoodini/ai-agents-skills

Edit any selfie or screen-share footage into a viral short-form video in YUV.AI's signature style — Apple-style liquid-glass cards (real CSS backdrop-filter), dark-mode polish, MrBeast-paced cuts, video-title karaoke captions, premium GSAP motion graphics, no fake content, never covering the speaker's face. Hebrew is rendered in Rubik Black, English in Anton uppercase. Always renders BOTH 9:16 and 16:9 and always saves with _V<N> suffix for backups. Trigger when the user drops a path to an .mp4/.mov/.mkv and says "edit this", "make it viral", "turn this into a short", or any Hebrew equivalent (ערוך סרטון, סרטון ויראלי, להפוך לוויראלי, ריל, שורט). The pipeline is the COMBINATION of two skills: video-use (transcription + word-snapped cuts + base extraction) and hyperframes (HTML/CSS/GSAP visual composition + render). Do NOT use for podcast-only audio edits.

hoodini/ai-agents-skills

Yuval Avidani's YUV.AI brand and design system. Apply ONLY when YUV.AI-branded output is requested — presentations, decks, keynotes, portfolio, brand site, profile, speaker bio, brand assets, or any prompt mentioning YUV.AI / "my brand" / "my deck" / "my site" / "for me". Do NOT auto-trigger on generic "build a game / web app / dashboard / landing page" without YUV.AI context — those use whatever palette fits. Three modes; NEON (hot pink #FF1464 + neon cyan #00E5FF + white, DEFAULT for YUV.AI web, apps, games, dashboards, social, general visual work); DECKS (Fly High purple/yellow/grey, presentations and slides ONLY); Warm Editorial (pink/yellow/bone for Hope, Marcus, bigcats.ai, practical.yuv.ai). Universal Fly High throughline across all modes; flight/progress motifs (HUD strips, dials, "Let's Fly High" tagline, phoenix mark). Anton + Inter (EN), Rubik + Assistant (HE), letter-spacing 0 default. Bundled brand assets, canonical socials, credentials. Project brand wins if specified.

hoodini/ai-agents-skills

Yuval's all-in-one AI video pipeline. Turns an idea/script into a finished, on-brand MP4 by orchestrating HyperFrames (HTML→deterministic video render), Lottie (branded motion graphics), ManimCE (math / neural-network / concept animations), and a transcribe→approve caption flow — all wrapped in the YUV.AI Neon Phoenix brand via a frame.md. Use whenever Yuval wants to make, edit, or explain something as a video: promo, explainer, launch, social reel, "make a video about X", "explain X as a video", "neural network animation", "turn this into a video", captioned tutorial, 16:9 or 9:16. Triggers: video, explainer, promo, reel, manim, lottie, hyperframes, animation, "make a video", "explain ... as a video", מצגת וידאו, סרטון, הסבר וידאו. Routes each beat to the right engine, wraps in brand, self-verifies, and renders.

hoodini/ai-agents-skills

Build a premium cinematic landing page with mouse-scrub video hero and brand-driven narrative-arc sections. Use whenever the user provides a hero video plus a product / subject / brand and wants a landing page, promo site, product showcase, marketing page, or storytelling site. Works for any language (RTL or LTR — Hebrew, English, Arabic, Spanish, French, Japanese, etc.) and any subject (food, tech, animals, fashion, services, SaaS, wildlife campaigns, music releases, books, real estate). The signature effect is mouse-driven video scrubbing — the hero video lives across the entire page as a fixed backdrop, and moving the mouse left-right scrubs the video timeline so the subject responds to the cursor. Below the hero, 4-5 fully-opaque sections each carry their own brand identity (color, typography emphasis, layout pattern) and walk the viewer through a narrative arc (e.g. longing → joy → nostalgia → contemplation → action). Triggers on phrases like "build a landing page from this video", "cinematic landing ...

hoodini/ai-agents-skills

Build a scroll-driven cinematic landing page from a short video. The user provides a 5–15 second video (often AI-generated); this skill extracts every frame at HD JPEG quality, then produces a single-hero HTML page where the user's scroll gesture scrubs the frames in place (the page itself never scrolls) and 5 dramatic text overlays crossfade in/out — Google Anton headlines, Caveat handwritten accents, locked body, virtual scroll. Use this skill whenever the user wants to "turn this video into a landing page", "make a scroll-scrub landing page", "build a parallax hero from this clip", "add a new landing page to the parasites showcase", "do the same as github/lion/hope for this new video", or any variant that pairs a short clip with dramatic scroll-triggered storytelling. Trigger even if the user only says "use my video for a landing page" — that is this skill.

hoodini/ai-agents-skills

Turn any video into a cinematic scroll-driven landing page — Apple-style hero where scrolling progresses the visible frame through the video. Use when the user provides a video file and asks for "a landing page from this video", "scroll-frame website", "Apple-style scroll site", "hero that scrubs the video", "like the GitHub Copilot landing", or any equivalent. Extracts N evenly-spaced frames via ffmpeg, builds a self-contained HTML page with a sticky hero + JS scroll listener that swaps the visible frame as you scroll, plus headline, sections and CTA below. For YUV.AI projects, applies the yuv-design-system skill in Neon mode (pink/cyan/white, default for YUV.AI web) — Decks (purple/yellow) is reserved for slides only. For generic / non-YUV.AI projects, picks an appropriate palette per the source video. Output is one folder with `index.html` and a `frames/` directory — drop on any static host.

hoodini/github-trending

Fetch and display GitHub trending repositories and developers. Use when building dashboards showing trending repos, discovering popular projects, or tracking GitHub trends. Triggers on GitHub trending, trending repos, popular repositories, GitHub discover.

hoodini/mongodb

Work with MongoDB databases using best practices. Use when designing schemas, writing queries, building aggregation pipelines, or optimizing performance. Triggers on MongoDB, Mongoose, NoSQL, aggregation pipeline, document database, MongoDB Atlas.

hoodini/owasp-security

Implement secure coding practices following OWASP Top 10. Use when preventing security vulnerabilities, implementing authentication, securing APIs, or conducting security reviews. Triggers on OWASP, security, XSS, SQL injection, CSRF, authentication security, secure coding, vulnerability.

관련 스킬