Communitygithub.com

avenoxai/avenoxskills

Avenox Studio — 로컬 우선 YouTube 비디오 제작 파이프라인 (ROUTER, 먼저 읽기). 긴 형식의 비디오를 편집, 자르기, 제작, 조립, 자막 추가, 배경 음악 삽입, 렌더링하거나 모션 그래픽을 만드는 모든 요청에 사용합니다. 오픈소스 도구(auto-editor, mlx-whisper, MLT/melt, ffmpeg)와 HyperFrames를 활용하여 애니메이션 그래픽을 생성합니다. 트리거: "이 비디오 편집", "녹화물 자르기", "그래픽 만들기", "자막 추출", "최종 렌더링", 작업 이름 또는 비디오 파이프라인과 관련된 모든 것. 사람은 감독/품질 게이트 역할을 하고, 에이전트는 운영자 역할을 합니다.

avenoxskills란 무엇인가요?

Avenox Studio는 로컬 우선(Local-first) 방식으로 에이전트가 운영하는 YouTube 비디오 제작 파이프라인입니다. 모든 처리는 사용자의 로컬 머신에서 이루어지며, 클라우드 편집기나 업로드-투-렌더(upload-to-render) 방식이 필요 없습니다. 이 시스템은 자동 편집(auto-editor), 전사(mlx-whisper), 비선형 편집(MLT/melt), 인코딩(ffmpeg) 등 오픈소스 도구를 활용하며, HyperFrames를 통해 애니메이션 그래픽을 지원합니다. 주요 운영 원칙으로는 미디어를 클라우드 동기화 폴더에 두지 않음, 미리보기 생성 후 감독 승인 후에만 최종 렌더링, 브랜드 사양을 엄격히 준수, YouTube 16:9 1080p60 포맷 고정, 하이브리드 마감(자동 드래프트 생성 후 Kdenlive/Shotcut에서 수동 마감 가능)이 있습니다. 이 스킬은 라우터 역할을 하며, 모든 비디오 요청을 먼저 읽고 적절한 하위 스킬(예: avenox-roughcut, avenox-graphics, hyperframes 등)로 라우팅합니다. 사람은 감독 및 품질 게이트 역할을 하고, 에이전트는 운영자 역할을 수행하는 '감독-운영자 루프(Director Loop)'가 가장 중요한 규칙입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/avenoxai/avenoxskills/tree/HEAD/skills/avenox-video

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

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

문서

Avenox Studio — 운영자 라우터

로컬 우선, 에이전트 운영 비디오 파이프라인을 위한 빠른 운영자 가이드입니다. 모든 것은 사용자의 로컬 머신에서 실행됩니다: 클라우드 편집기나 업로드-투-렌더(upload-to-render)가 없습니다.

사람은 감독하고 품질을 승인합니다; 에이전트는 파이프라인을 운영합니다.

설정

export STUDIO_JOBS="$HOME/video/projects"   # 무거운 미디어 파일이 있는 곳
export STUDIO_ROOT="/path/to/this/repo"     # 스크립트, 템플릿, 브랜드 파일

요구 사항: macOS (h264_videotoolbox를 통한 하드웨어 인코딩; mlx-whisper를 위한 Apple Silicon), ffmpeg, python3, melt/MLT, Node (HyperFrames용). 대부분은 libx264와 대체 CUDA whisper 빌드를 사용하여 Linux에서도 작동합니다.

운영 원칙

  1. 미디어 규율. 무거운 미디어는 절대 클라우드 동기화 폴더에 두지 마십시오 — 동기화는 수 GB 중간 파일을 처리할 때 심하게 부하를 주고 쓰기 중인 파일을 손상시킬 수 있습니다. 작업은 $STUDIO_JOBS// (raw/ cut/ graphics/ audio/ outputs/) 안에 있습니다. 메모 시스템에는 핵심만 저장합니다: 이 시스템, 브랜드 사양, edit.json 계획.
  2. 감독 루프. 미리보기를 생성(그래픽 스틸 + 빠른 드래프트 렌더) → 피드백 전송 → 그 후에만 최종 렌더링합니다. 승인 없이 최종본을 절대 보내지 마십시오. 이것이 가장 중요한 규칙입니다; 검토되지 않은 최종본을 렌더링하는 에이전트는 거부된 컷에 몇 시간을 소모할 것입니다.
  3. 브랜드는 제안이 아니라 엄격한 제약 사항입니다. 그래픽을 만들기 전에 brand/frame.md를 읽으십시오. 한 번 정의하고 고정하십시오. (참조 구현은 의도적으로 'AI 슬롭'과 반대입니다: 프리미엄 편집, 따뜻한 종이 + 잉크 + 단일 악센트, 네온/그라데이션/글라스모피즘/3D 광택 없음.)
  4. 포맷: YouTube 16:9 1080p60. brand/presets/youtube-16x9.json에 사전 설정.
  5. 마감은 하이브리드입니다. 드래프트를 자동 생성; 동일한 .mlt 파일이 Kdenlive 또는 Shotcut에서 열려 수동 마감할 수 있습니다. 취향을 자동화하려 하지 마십시오.
  6. 전사 기본값은 로컬 mlx-whisper와 whisper-large-v3-turbo를 사용합니다 — 빠르고, 무료이며, 비영어 오디오에 강력합니다. 대부분의 LLM 라우팅 프록시는 whisper 엔드포인트를 노출하지 않습니다; 원격으로 전환하는 경우 전용 음성 API를 사용하십시오.

스크립트 (scripts/)

스크립트기능
autocut.sh IN.mp4 [balancedaggressive
transcribe.py IN.mp4 PREFIX→ transcript/PREFIX_timed.json + _narration.txt
mltgen.py edit.json out.mlt --base 편집 목록 → MLT 프로젝트 (Kdenlive/Shotcut/melt)
vrender.sh project.mlt out.mp4 [fastquality]
grabshot.sh클립보드 스크린샷 → 디스크
slides2png.sh레거시 정적 슬라이드 — HyperFrames 선호
remove-silence.py독립 무음 제거 패스

7단계

  1. 인테이크 — 원본 파일 복사 → $STUDIO_JOBS//raw/. 브리프와 실제로 중요한 세그먼트를 확인합니다.
  2. 러프 컷 — autocut.sh raw.mov balanced → cut/screen_cut.mp4; 스크립트를 위해 transcribe.py 실행. 전체 레시피 → avenox-roughcut 스킬.
  3. 그래픽 — HyperFrames. hyperframes 스킬을 통해 라우팅 → 일반적으로 motion-graphics (짧은 비트), faceless-explainer (개념 설명), 또는 general-video. 먼저 brand/frame.md를 읽고; 애니메이션 MP4를 graphics/에 렌더링합니다. 전체 레시피 → avenox-graphics 스킬.
  4. 조립 — cut/.mp4 + graphics/.mp4 + 음악을 혼합하여 edit.json 작성 (templates/edit.json에 템플릿 있음) → mltgen.py edit.json project.mlt --base .
  5. 자막 — transcribe.py → .srt; brand/caption-corrections.json 적용 (caption-corrections.example.json에서 복사 — ASR이 자주 망가뜨리는 용어를 찾아 바꾸는 맵입니다). YouTube CC로 제공하고, 화면에 박지 마십시오.
  6. 음악 — 모든 것 아래에 배경 음악을 깔고, 음성 아래에서 사이드체인 덕킹, 목표 ~-14 LUFS. CREDITS.md에 속성을 기록합니다.
  7. 내보내기 — vrender.sh project.mlt draft.mp4 fast → 감독 검토 → vrender.sh … final.mp4 quality → 임시 파일 정리.

그래픽 품질 기준

HyperFrames 클립은 brand/frame.md를 따라야 합니다. 유형 중심, 절제되고 무게감 있는 움직임을 선호합니다. 비트에 움직임이 필요하지 않다면 깔끔한 정적 프레임도 괜찮습니다 — 애니메이션을 위해 애니메이션을 만들지 마십시오.

참고

  • 러프 컷: avenox-roughcut · 그래픽: avenox-graphics
  • HyperFrames 스킬: hyperframes (라우터), hyperframes-cli, hyperframes-animation, hyperframes-creative, motion-graphics, faceless-explainer, general-video
  • 브랜드 사양: brand/frame.md (brand/frame.template.md에서 채워 넣기)

관련 스킬