Communitygithub.com

yunjundai/video-editing-skills

무료 로컬 도구를 사용하여 기존 비디오와 사진을 편집하고, 번체 중국어 자막, 영화 같은 인트로, 이름표, 텍스트 애니메이션 및 전환을 제작하며 수정 가능한 프로젝트를 유지합니다. 학교 행사, 인터뷰, 기념 비디오 및 일반 비디오 편집에 적합합니다.

video-editing-skills란 무엇인가요?

이 스킬은 AI 에이전트가 FFmpeg, Remotion, faster-whisper, OpenCC와 같은 무료 로컬 도구를 사용하여 사용자의 미디어 파일(비디오 및 사진)을 전문적인 비디오로 편집할 수 있도록 지원합니다. MCP, 유료 API 또는 클라우드 렌더링에 의존하지 않고 완전히 오프라인에서 작동하므로 개인 정보 보호 및 비용 효율성이 뛰어납니다. 이 스킬은 자동으로 프로젝트를 초기화하고, 미디어를 분석하며, 자막을 생성하고, 사용자가 선호하는 편집기(DaVinci Resolve 또는 Shotcut)를 기반으로 하는 사용자 정의 가능한 Remotion 템플릿을 사용하여 영화 같은 효과를 통합합니다. 주요 기능으로는 오디오 전사, 번체 중국어 자막 생성, 장면 감지, 전환, 텍스트 애니메이션 및 이름표가 있으며, 최종 비디오와 완전히 수정 가능한 프로젝트 파일(project.json, 소스 이미지/비디오, 자막)을 제공하여 에이전트나 사용자가 추가 조정을 할 수 있습니다. 또한 렌더링된 비디오의 품질을 확인하고, 데모 버전을 미리 보며, 일반적인 오류(예: 블랙 프레임, 무음)를 감지하는 스크립트도 포함되어 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yunjundai/video-editing-skills/tree/HEAD/cinematic-video-editing

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

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

문서

영화감독급 비디오 편집

다른 AI 에이전트가 이 스킬을 사용, 설치 또는 패키징하기 전에 agent-compatibility.md를 읽고 대상 플랫폼에 따라 스킬 디렉토리와 로컬 설정을 처리하세요.

사용자의 오디오/비디오 자료를 시청 및 수정 가능한 비디오로 제작합니다. FFmpeg, Remotion, faster-whisper 및 OpenCC를 자동으로 사용하며, 정밀 편집은 local-environment.json의 preferred_editor에 따라 설치된 DaVinci Resolve 또는 Shotcut을 선택합니다. MCP, 유료 API, 클라우드 렌더링 또는 유료 효과에 의존하지 않습니다. 사용자가 지정한 편집기, 스타일 및 전달 형식을 따릅니다.

로컬 환경

처음 사용하기 전에 local-environment.example.json을 references/local-environment.json으로 복사하고 실제 도구 위치를 입력하세요. 예제 경로는 도구가 설치되었음을 의미하지 않습니다.

먼저 references/local-environment.json을 읽어 도구의 절대 경로를 확인하세요. Python 종속성은 전용 venv에 있습니다. 해당 venv의 python을 사용하고, 시스템 Python을 사용하여 음성 인식을 실행하지 마세요. scripts/project.py doctor를 사용하여 환경을 확인하세요. 프로젝트 생성, 미리보기 및 출력 명령은 project-commands.md를 참조하세요. scripts/ 및 assets/는 이 스킬 폴더를 기준으로 합니다. 명령은 절대 경로와 매개변수 배열을 사용하고, 중국어 및 공백 경로를 올바르게 처리하세요.

시작하기

도구 환경을 이동하거나 재구축해야 하는 경우에만 environment-notes.md를 읽고, 테스트된 버전으로 잠금 파일을 사용하여 재구축하세요.

  • 요구 사항과 자료를 바탕으로 접근 방식을 추정하고, 제품에 영향을 미치는 정보가 부족한 경우에만 질문하세요. 길이, 화면 비율, 중요한 내용 및 스타일을 확인하세요. 지정되지 않은 경우 16:9, 1080p, 30fps 미리보기로 시작할 수 있습니다.
  • 자료 경로가 불명확한 경우, 먼저 현재 작업 디렉토리를 확인하고, 빈 폴더를 기존 자료로 오인하지 마세요. 원본 파일을 보존하고, 파생 파일은 새 작업 폴더에 저장하세요.
  • media.py inventory를 사용하여 길이, 화면 비율, 오디오 정보 및 썸네일이 포함된 목록을 만드세요. 필요한 경우에만 프록시를 생성하거나 media.py scenes를 사용하여 컷 포인트를 찾으세요. 실제 명령은 media-commands.md를 참조하세요.
  • 대표 화면을 보고, 음성을 듣고, 대본을 읽은 후 자료를 선택하세요. 컷 감지는 단지 화면 변화만 감지할 뿐이며, 프레임 추출은 동작을 놓칠 수 있습니다. 추측된 장면, 사람 이름 또는 활동 사실을 확인된 내용으로 간주하지 마세요.

편집 및 모션 디자인

  1. 섹션 및 자료 시작/종료 목록을 만드세요. 학교 완공 비디오는 인트로, 캠퍼스 및 역사, 활동 및 인터뷰, 비전, 감사 아웃트로로 구성할 수 있습니다. 자료에 따라 조정하세요.
  2. scripts/project.py init <새 프로젝트 디렉토리>를 사용하여 준비된 Remotion 템플릿을 복사하세요. 선택한 자료를 해당 프로젝트의 public/media/에 복사하여 원본을 수정하지 않도록 하세요.
  3. public/project.json의 장면, 진입점, 길이, 전환, 자막 및 이름표를 편집하세요. 데이터 사양은 motion-template.md를 참조하세요. 비디오 자료는 먼저 ffprobe로 크롭 영역을 확인하세요. 템플릿은 인트로, 챕터, 사진 확대/축소, 비디오, 인용문, 감사 아웃트로 및 fade/wipe/slide를 지원합니다.
  4. 먼저 작은 부분을 미리 본 다음 전체 영상을 제작하세요. project.py still을 사용하여 특정 시간을 확인하고, project.py render --scale 0.5를 사용하여 빠른 미리보기를 하세요. 최종 전달 시에만 원래 크기를 사용하세요.

일관된 글꼴, 색상 구성, 안전 여백 및 애니메이션 리듬을 유지하세요. 자간 확장, 라인 공개, 마스크 및 ease-in-out을 사용하여 품질을 향상시킬 수 있습니다. 사람 이름, 직함, 날짜, 제목 및 색상 구성을 수정 가능한 데이터에 넣으세요. 긴 텍스트는 줄 바꿈하거나 줄이고, 매우 작은 글꼴을 억지로 사용하지 마세요.

추가 효과는 템플릿 소스 코드에 사용자 정의 애니메이션을 추가하여 구현할 수 있습니다. 필요한 경우 설치된 공식 remotion-best-practices, remotion-captions, remotion-render 스킬 또는 공식 문서를 참조하세요. 기본 템플릿은 독립적으로 실행할 수 있습니다. 무료이고 호환되는 효과만 사용하세요. 실제 필요가 있을 때만 Blender로 3D 장면을 사용하고, 자동으로 대규모 옵션 도구를 설치하지 마세요.

번체 자막 및 오디오

  • scripts/transcribe.py와 준비된 로컬 small 모델을 사용하여 SRT 및 단어 시간이 포함된 captions.json을 생성하세요. CPU/int8도 사용 가능하며 CUDA가 필요하지 않습니다. GPU 가속은 먼저 종속 패키지를 확인해야 합니다.
  • OpenCC는 단어만 변환합니다. 학교 이름, 사람 이름, 직함, 날짜, 동음이의어 및 대만어는 여전히 교정이 필요합니다. 인식이 불명확한 부분은 확인을 위해 표시를 남기고, 날조하지 마세요.
  • 편집된 대화 오디오 트랙을 인식하거나, 각 자료의 컷 및 전환 오버랩을 기준으로 최종 타임라인으로 변환하세요. 원본 자료의 자막 시간을 편집된 비디오에 직접 붙여넣지 마세요.
  • captions.json의 captions 배열은 project.json으로 이동할 수 있습니다. 시작 및 종료 시간은 최종 비디오의 초입니다. 단어별 하이라이트는 안정적인 단어 시간이 필요합니다. 전체 문장 시간만 있는 경우 전체 문장을 표시하세요.
  • 자막과 이름표는 읽기 쉽고 서로를 가리지 않도록 하세요. 원본 오디오 전환은 중첩된 클립을 동시에 재생합니다. 인터뷰는 가능한 문장 경계에서 자르고, 필요한 경우 오디오를 별도로 처리하세요. 배경 음악은 음성을 명확하게 유지하고, 자료에 적합한 볼륨과 페이드 인/아웃을 사용하세요.

전달 및 검사

  • media.py check를 사용하여 디코딩 오류, 블랙 프레임 및 무음을 확인하세요. 검은 화면이나 무음은 의도된 디자인일 수 있으므로 사람이 판단하세요. 시작, 전환 중간, 자막이 가장 긴 부분, 이름표 및 끝 부분을 스팟 체크하고, 음성과 배경 음악을 들어 확인하세요.
  • 소스 코드, project.json, 사용된 자료 및 SRT를 보존하고, MP4, 썸네일 및 수정 방법을 전달하세요. 기존 결과물을 덮어쓰지 않고 새 버전을 출력하거나 --overwrite를 명시적으로 사용하세요.
  • project.py shotcut은 렌더링 결과가 포함된 Shotcut 정밀 편집 시작점을 만들 수 있습니다. 텍스트는 Shotcut 네이티브 텍스트 레이어가 되지 않습니다. 텍스트나 애니메이션을 변경하려면 Remotion 프로젝트로 돌아가서 다시 렌더링해야 합니다. 렌더링된 효과를 네이티브 편집 가능한 텍스트라고 주장하지 마세요.
  • 투명 애니메이션을 위해서는 전용 투명 Composition을 만들고, RGBA PNG 시퀀스 또는 호환되는 알파 인코딩을 출력하고 실제로 테스트하세요. 일반 H.264 MP4는 투명도를 유지하지 않습니다.
  • Resolve를 사용한 정밀 편집 또는 직접 제어가 필요한 경우 resolve-guide.md를 읽으세요. Resolve 제어는 대상 컴퓨터에서 실제로 테스트하세요. 내장 Lua 콘솔을 사용하여 프로젝트 생성, 미디어 가져오기, 타임라인 생성 및 DRP/MP4 출력이 가능합니다. GUI 작업에는 사용 가능한 computer-use 스킬을 사용하세요. 무료 버전에서 외부 스크립팅 연결이 가능하다고 가정하지 마세요. scripts/resolve_verify.lua는 최대 9.8초 제어 검증용입니다. 실제 편집 시에는 공식 API와 화면 조작을 필요에 따라 사용하고, 단계별로 결과를 검증하세요. 네이티브로 텍스트를 편집할 수 있는 효과가 필요하면 Fusion 템플릿을 만들고 실제로 검증하세요. Remotion 결과물을 네이티브 노드로 간주하지 마세요.

완료 시 결과물 및 수정 가능한 프로젝트 위치, 검증된 기능 및 교정해야 할 내용을 설명하세요. 설치 상태는 doctor 및 실제 실행을 기준으로 합니다. 편집 엔진은 로컬에서 무료이며, AI 에이전트 계정 크레딧은 별도입니다.

Individual skills in this repo

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

관련 스킬