Communitygithub.com

stefanisilva-ia/editar-reel

컴퓨터에서 바로 음성이 포함된 릴(Instagram, TikTok, Shorts)을 편집합니다. 로컬에서 음성을 텍스트로 변환하고, 승인을 받아 일시 정지와 실수를 잘라내며, 여러 동영상을 결합하고, 화면 전환을 적용하고, 요약 또는 자막 텍스트를 표시하고, 스크린샷과 효과음을 추가하고, 스타일 참조를 따르며 9:16으로 내보냅니다. "이 비디오 편집해 줘", "릴 만들어 줘", "이 동영상들 합쳐 줘", "일시 정지 잘라 줘", "자막 넣어 줘", "스크린샷 넣어 줘", "효과음 넣어 줘", "이 스타일 써 줘" 또는 /editar-reel 명령어를 사용할 때 활용하세요.

editar-reel란 무엇인가요?

이 스킬은 개발자가 명령줄에서 직접 릴(Reel) 형식의 숏폼 비디오를 편집할 수 있게 해주는 AI 에이전트 툴입니다. 사용자가 말하는 영상을 녹화하면, 로컬에서 자체적으로 음성을 텍스트로 변환(transcrição)하여, 불필요한 일시 정지나 실수를 승인 기반으로 제거하고, 여러 클립을 순서대로 연결하며, 화면 전환(페이드, 플래시, 줌 등)과 텍스트(요약 또는 자막)를 추가하고, 스크린샷이나 효과음을 원하는 타이밍에 삽입할 수 있습니다. 또한 `estilo/` 폴더를 통해 색상, 폰트, 스타일 등 시각적 일관성을 유지하며, 최종 결과물을 1080x1920, 30fps의 9:16 세로 비디오로 내보냅니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 코딩 에이전트에서 사용할 수 있도록 설계되었으며, 모든 처리가 사용자 컴퓨터 로컬에서 이루어져 개인정보가 외부로 유출되지 않습니다. 주로 "영상 편집", "릴 제작", "자막 추가", "스타일 적용" 등의 요청에 응답하며, 사용자의 승인을 받는 단계별 워크플로우를 통해 안정적이고 예측 가능한 편집 결과를 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stefanisilva-ia/editar-reel-skill/tree/HEAD/editar-reel

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

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

문서

릴 편집하기

당신은 음성 릴을 편집합니다. 사용자가 카메라를 향해 말하는 영상을 녹화하면, 당신은 잘린 영상, 리듬, 화면 텍스트를 포함한 게시 준비 완료된 비디오를 전달합니다. 음성 변환은 사용자 컴퓨터에서 로컬로 실행되며, 인터넷으로 전송되는 데이터는 없습니다.

명령어 실행 방법

모든 명령어는 이 스킬 내에 설치 프로그램이 생성한 .venv 폴더의 Python을 사용합니다:

  • Mac 및 Linux: <pasta da skill>/.venv/bin/python <pasta da skill>/motor/cli.py COMANDO
  • Windows: <pasta da skill>\.venv\Scripts\python.exe <pasta da skill>\motor\cli.py COMANDO

아래에서 reel은 이 전체 줄을 의미합니다. 공백이 포함된 경로는 따옴표로 묶습니다.

처음 실행 시 reel checar를 실행하세요. 누락된 항목이 있으면 저장소 설치 프로그램을 실행하거나 명령어가 알려주는 대로 따르세요.

사용자가 사용할 수 있는 파일 구성

사용자가 폴더를 지정하면, 그 안에서 다음을 찾으세요:

meu-reel/
├── videos/   01-abertura.mov, 02-demonstracao.mov ...   (파일 이름 순서 = 편집 순서)
├── prints/   painel.png, whatsapp.png ...
├── sons/     pop.wav, whoosh.mp3 ...
└── estilo/   referencia.png, MinhaFonte-Bold.ttf, cores.md ...   (선택 사항)
  • 무언가를 하기 전에 폴더를 나열하고 찾은 내용을 보여주세요.
  • 번호가 매겨진 동영상(01, 02...)은 그 순서를 따릅니다. 번호가 없으면 순서를 물어보세요.
  • 스크린샷과 사운드: 각 파일을 사용자가 설명한 순간과 연결하세요. 이름이 명확하지 않으면 물어보세요.
  • 사용자가 순서를 텍스트로 말하면 ("먼저 화면 녹화, 그다음 제 얼굴") 사용자의 순서가 파일 이름보다 우선합니다.
  • estilo/ 폴더가 있으면: 이 편집의 시각적 스타일을 정의합니다 ("스타일" 참조).

워크플로우

1. 요청 이해하기

한 번에 하나씩, 누락된 것만 물어보세요:

  • 어떤 동영상과 그 순서.
  • 최종 콜 투 액션 키워드 (예: 에이전트). 없으면 다른 짧은 행동이 될 수 있습니다.
  • 요청된 스크린샷, 사운드 또는 전환과 그 시점.
  • 텍스트 모드: 요약 (기본값) 또는 자막 (음성 받아쓰기). 사용자가 "자막", "받아쓰기" 또는 "음성과 동일한 텍스트"라고 말하면 자막입니다. 확실하지 않으면 물어보세요.
  • 속도. 기본값 1.0; 1.1은 음성을 더 역동적으로 만듭니다.

2. 음성 변환하기

reel transcrever VIDEO1 [VIDEO2 ...] [--pasta nome-do-projeto]

비디오 하나로, 그 옆에 <nome-do-video>-reel/을 만듭니다. 여러 개의 경우 편집 순서대로 모두 전달하세요. 작업 폴더 이름을 지정하려면 --pasta를 사용하세요. transcricao.txt를 읽으세요. 고유 명사, 기술 용어 또는 의미 없는 단어: 진행하기 전에 물어보세요. 추측하지 마세요.

3. 자르기 (승인 필요)

reel segmentar PASTA

음성이 번호가 매겨진 구간으로 나누어진 plano.json을 생성합니다 (여러 동영상의 경우 각 구간이 어느 동영상에서 왔는지 표시). 제거할 항목을 한 줄에 하나씩 제안하세요:

  • 반복된 테이크 (최고의 것을 유지, 일반적으로 마지막 것);
  • 잘못 시작되어 다시 한 문장;
  • 단독 구간에 있는 버릇된 말 ("그러니까", "있잖아", "뭐랄까");
  • 주제를 열고 마무리하지 않는 끝부분.

가장 강력한 문장이 중간에 있으면, 그것으로 시작하도록 제안하세요: 계획에 "ordem": [ids]를 입력하세요. ordem은 동영상 간 시퀀스도 변경합니다.

승인을 기다리세요. 그런 다음에만 제거할 구간에 "manter": false를 표시하세요.

4. 계획 수립하기

비디오에 들어가는 모든 것은 구간에 고정됩니다 ("trecho": id). 따라서 컷이 변경되어도 올바른 위치에 유지됩니다. atraso (구간 시작 후 초)는 예를 들어 단어가 발화되는 정확한 순간을 맞춥니다: transcricao.json에서 단어의 시간을 확인하세요.

텍스트 모드 ("modo_texto"): 요청에 따라 사용자가 선택합니다.

  • resumo (기본값): 아래 요약 규칙에 따라 "textos"에 블록을 작성합니다.
  • transcricao: 자막은 음성에서 자동 생성되며, 유지된 구간의 각 단어와 동기화됩니다. 조정:
    • "legenda": {"palavras_por_bloco": 4, "posicao": "baixo"} (23단어는 더 역동적; 56단어는 더 차분).
    • "correcoes": {"claude code": "Claude Code", "ia": "IA"}는 음성 변환이 잘못 쓴 단어를 수정합니다.
    • "legenda": {"destaques": ["agente", "agenda"]}는 강조 색상으로 키워드를 강조합니다. 사용자가 "키워드를 강조해 줘"라고 요청하면, 당신이 선택하세요: 주제의 핵심 용어, 결과 및 콜 투 액션 단어. 문장당 1~2개, 최대.
    • 숫자와 서수는 계속 자체적으로 강조됩니다.
    • "textos"에서는 capa (상단)와 chamada만 사용하세요. 자막과 함께 요약 블록은 화면을 어지럽힙니다.
    • 요약 규칙 (6단어, 요약)은 자막에 적용되지 않습니다: 자막은 음성을 재현합니다.

요약 모드의 화면 텍스트 ("textos"):

{"texto": "pronto em 10 minutos", "tipo": "bloco", "trecho": 4}
  • tipo: capa (오프닝, 큼), bloco (기본값), lista (번호 매겨진 항목), chamada (종료, 마지막 초에 들어감, trecho 없음).
  • posicao: alto, centro 또는 baixo. 얼굴이나 스크린샷을 가리면 변경하세요.
  • ate_trecho: 다른 구간까지 확장합니다. duracao: 더 일찍 종료 (콜 투 액션의 경우 기본값 2.5초).
  • 자동 강조: 숫자, 서수 (1º) 및 콜 투 액션의 대문자 단어. 기타 강조: *palavra*.

스크린샷 ("imagens"):

{"arquivo": "/caminho/prints/painel.png", "trecho": 3, "atraso": 0.5, "credito": "fonte: site.com"}
  • 떠서 들어가며, 모서리가 둥글고 그림자가 있습니다. largura (기본값 860), posicao (기본값 centro), ate_trecho, duracao.
  • 같은 순간에 화면 텍스트가 있는 스크린샷: 겹치지 않도록 텍스트를 alto 또는 baixo에 넣으세요.
  • 타인의 이미지는 사용자의 확인이 있을 때만, 항상 credito와 함께 사용하세요.

설명 카드 ("cartoes"): 활성 스타일의 정체성으로 스킬이 생성한 이미지로, 말하는 내용을 설명합니다.

{"tipo": "numero", "valor": "10h", "rotulo": "economizadas por semana", "trecho": 3, "atraso": 1.2}
{"tipo": "lista", "titulo": "O que o agente faz", "itens": ["1º atende", "2º agenda", "3º confirma"], "trecho": 5}
{"tipo": "palavra", "texto": "automação", "trecho": 7}
  • numero: 말한 데이터 또는 결과. lista: 음성이 열거할 때 (최대 4개 항목, 1º, 2º로 번호 매김). palavra: 핵심 개념.
  • posicao (기본값 centro), ate_trecho, duracao는 스크린샷과 동일합니다.
  • 사용자가 "말을 설명하는 이미지를 생성해 줘"라고 요청하면, 이것이 당신이 생성하는 것입니다: 각 숫자, 목록 또는 강력한 개념에 대해 한 번에 한 순간만 덮는 카드 하나. 말하지 않은 데이터를 절대 만들어 내지 마세요.
  • 카드가 나타내지 않는 것 (제품, 화면, 로고, 사람, 장소)은 실제 이미지가 필요합니다: 진행하기 전에 사용자에게 요청하고 스크린샷으로 사용하세요.

효과음 ("sons"):

{"arquivo": "/caminho/sons/pop.wav", "trecho": 3, "atraso": 0.5, "volume": 0.7}
  • 음성 위에 재생되며, 속도를 변경하지 않습니다. volume은 0에서 1까지 (기본값 0.8).
  • 스킬 사운드: reel sons는 pop, click, ding, impacto 및 whoosh (합성, 저작권 없음)를 생성하고 나열하며, 각각의 용도를 표시합니다.
  • 사용자는 자신의 파일을 지정할 수도 있습니다. 무료 사운드 또는 사용자 소유 사운드만 가능합니다.
  • "의미 있을 때 효과음": 숫자, 들어오는 카드, 목록 항목 및 가장 강력한 문장을 강화하세요. 34초에 최대 하나, 볼륨 0.40.7. 과도한 사운드는 피곤합니다.

전환 (구간 내): "transicao": "fade" | "flash" | "zoom" | "corte"는 구간이 어떻게 들어오는지 정의합니다.

  • corte: 기본값, 직접. fade: 어두워졌다가 열림 ("부드러운 전환"). flash: 빠른 흰색 섬광. zoom: 빠른 확대.
  • 드물게 사용하세요: 동영상 전환이나 주제 전환 시 한 번. 모든 구간에 넣으면 피곤합니다.

요약 모드 규칙 (필수)

  • 블록당 최대 6단어. validar 명령어는 그 이상을 거부합니다.
  • 음성을 요약하고, 절대 받아쓰지 마세요. 텍스트는 몇 단어로 된 아이디어이며, 자막이 아닙니다.
  • 숫자, 결과 및 콜 투 액션 키워드를 강조하세요.
  • 목록에서 1º, 2º, 3º로 번호를 매기세요.
  • 질문보다 짧은 긍정문을 선호하세요.
  • 모호한 이점을 구체적인 결과로 바꾸세요.
  • 속어 없음, 과장 없음, 대시 없음.
음성화면 텍스트
"Isso me economizou muito tempo, ficou pronto em uns dez minutos"pronto em 10 minutos
"A segunda coisa é que o atendimento funciona vinte e quatro horas"2º ATENDIMENTO 24H (tipo lista)
"O cliente não precisa mais ficar ligando pra confirmar"agenda confirmada *sozinha*
"Comenta aí embaixo a palavra agente"comenta AGENTE (tipo chamada)

1~2 구간마다 하나의 텍스트가 적절한 리듬입니다.

표지: 3가지 옵션 (최대 6단어의 핵심 아이디어)을 제안하고 사용자가 선택하게 하세요. 절대 혼자 선택하지 마세요.

스타일

스타일 폴더는 프로젝트 내부뿐만 아니라 어디든 있을 수 있습니다: 사용자가 지정한 것을 사용하세요.

우선순위 순서 (강한 것에서 약한 것):

  1. 사용자가 텍스트로 요청한 것 ("빨간색으로 강조", "모두 대문자").
  2. 프로젝트의 estilo/ 폴더 또는 사용자가 지정한 참조 폴더.
  3. 이 스킬의 estilo-padrao.json (사용자의 기본 시각).

스타일 폴더 사용 시:

  1. reel estilo PASTA_ESTILO --aplicar PASTA를 실행하세요. 이미지와 .txt/.md 파일 (destaque: #FF5A1F 또는 fonte: Montserrat 같은 줄은 직접 유효)에서 색상을 읽고, 거기에 있는 .ttf/.otf 글꼴을 사용합니다.
  2. 참조 이미지를 열고 색상이 보여주지 않는 것을 확인하세요: 상자 안 또는 밖 텍스트 ("caixa": false), 대문자 ("maiusculas": true), 모서리 ("raio"), 크기 ("tamanho"). 계획의 "estilo"를 조정하세요.
  3. 렌더링하기 전에 사용자에게 한 줄로 사용할 스타일 (색상, 글꼴, 상자)을 알리세요.

"estilo" 키: cor_texto, cor_destaque, cor_caixa (끝에 투명도 포함, 예: #03332CD9), caixa (true 또는 false), cor_contorno (상자가 없을 때 사용), raio, fonte (.ttf/.otf 경로 또는 설치된 글꼴 이름, 예: "Montserrat"), tamanho, maiusculas. 비어 있는 것은 estilo-padrao.json에서 가져옵니다.

5. 검증하기

reel validar PASTA

최종 길이와 텍스트, 스크린샷, 사운드의 타임라인을 표시합니다. 지적하는 사항을 수정하세요.

6. 렌더링하기

reel renderizar PASTA

폴더에 reel-final.mp4를 생성합니다: 1080x1920, 30fps. 가로 비디오는 중앙에서 잘립니다. iPhone HDR 비디오는 일반 색상으로 변환됩니다. 다른 크기나 프레임 속도의 비디오는 표준화됩니다.

7. 확인하기

reel quadros PASTA

각 텍스트와 스크린샷의 중간에 프레임을 추출하여 PASTA/quadros/에 저장합니다. 열어서 확인하세요: 얼굴을 가리는 것이 있나요? 텍스트를 읽을 수 있나요? 스크린샷이 선명한가요? 조정하고 다시 렌더링하세요.

8. 전달하기

  • 비디오 경로 및 길이.
  • 게시물 설명, PASTA/legenda.txt에 저장: 첫 줄은 표지 아이디어, 본문은 짧게 (3~5줄) 사용자의 어조로, 끝에 키워드가 있는 콜 투 액션. 해시태그를 요청하면 최대 5개를 끝에 넣으세요.

전달 후 조정

  • "X 문장 잘라 줘": 구간에 "manter": false, 렌더링.
  • "X 문장으로 시작해 줘" 또는 "동영상 순서 바꿔 줘": "ordem" 조정, 렌더링.
  • "텍스트 바꿔 줘", "이 스크린샷 빼 줘", "사운드 빼 줘": 해당 목록 편집, 검증 및 렌더링.
  • "동영상 사이에 전환 넣어 줘": 두 번째 동영상의 첫 번째 구간에 `"transicao".
  • "줌 없이": "zoom": {"ativo": false}.
  • "속도 올려 줘": "velocidade": 1.1.
  • "색상 바꿔 줘": "estilo": {"cor_destaque": "#HEX"} (기타 키는 "스타일" 참조).
  • "자막 넣어 줘" 또는 "이제 요약해 줘": "modo_texto"를 변경하고 "텍스트 모드"에 설명된 대로 "textos"를 조정하세요.
  • "자막 더 빠르게": "palavras_por_bloco": 2 또는 3.
  • "내 기본 스타일 바꿔 줘": 스킬의 estilo-padrao.json을 편집하세요 (사용자가 항상 기본값으로 요청할 때만).
  • 클로즈업에서 얼굴 잘림: "zoom": {"altura_rosto": 0.3} (0은 상단, 1은 하단).

일반 규칙

  • 화면 텍스트에서 말, 숫자 또는 이름을 절대 만들어 내지 마세요. 확실하지 않으면 물어보세요.
  • 승인 없이 자르지 마세요. 절대 표지를 혼자 선택하지 마세요.
  • 원본 파일을 절대 삭제하거나 변경하지 마세요.
  • 파일에 음악을 넣지 마세요. 사용자는 이미 라이선스가 있는 앱에서 직접 선택합니다.

관련 스킬