Communitygithub.com

reel-tela-viva

Tela Viva 스타일. "튜토리얼 온 스크린" 스타일(범용 창 사용, 번호 매겨진 단계, 단어 단위 자막)의 애니메이션 9:16 Reel을 브랜드 색상과 @계정으로 생성합니다. "Tela Viva" 또는 앱 화면을 보여주는 짧은 튜토리얼 Reel/비디오를 요청할 때 사용하세요.

reel-tela-viva란 무엇인가요?

이 스킬은 사용자가 제공한 주제를 바탕으로 '화면 튜토리얼' 스타일의 9:16 세로형 Reel(1080×1920, 30fps, MP4)을 제작합니다. Python + ffmpeg으로 렌더링되며, AI 비디오 생성기를 사용하지 않아 40초짜리 Reel을 1분 이내에 빠르게 제작할 수 있습니다. 비디오는 상단에 진행률 표시줄과 단계 번호, 중앙에 텍스트 애니메이션(입력, 강조 표시, 민감한 데이터 블러 처리)이 포함된 범용 창, 하단에 단어 단위 자막(브랜드 색상 강조)으로 구성됩니다. 사용자는 먼저 주제, 브랜드 색상(16진수), 프로필 @를 제공해야 합니다. 그런 다음 스크립트가 5~8개의 장면(30~60초)으로 구성된 `roteiro.json` 스크립트를 생성하며, 내레이션 속도는 초당 약 2.3단어입니다. 각 장면은 특정 창 '유형'(예: 목록, 텍스트, 채팅, 스프레드시트)을 사용하며, 선택적 포스트잇(`nota`)과 떠 있는 레이블(`pílula`)을 포함할 수 있습니다. 최종 비디오는 `scripts/reel.py`로 생성되며, 음악과 키보드 사운드가 포함됩니다. 사용자가 나중에 오디오 파일을 제공하면 음성 해설과 동기화할 수 있습니다. 스킬은 먼저 미리보기 이미지를 생성하여 레이아웃을 확인하고, 최종 MP4를 제공하기 전에 사용자의 승인을 받도록 권장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adnytamires/skills-reels-video/tree/HEAD/reel-tela-viva

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

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

문서

Tela Viva: 애니메이션 튜토리얼 Reel

3가지 스타일 키트: 사용자가 스타일을 지정하지 않고 Reel을 요청했을 때 Modo 8-Bit(픽셀 아트) 및 Hora Dourada(스토리 및 튜토리얼용 플랫 캐릭터) 스킬도 보유한 경우, 먼저 세 가지 스타일 중 원하는 것을 물어보세요.

이 스킬은 주제를 화면 튜토리얼 스타일의 세로형 Reel(1080×1920, 30fps, MP4)로 변환합니다:

  • 상단: 진행률 표시줄과 짧은 제목 옆에 단계 번호;
  • 중앙: "작동하는"(텍스트 입력, 응답 표시, 강조 표시, 민감한 데이터 위 검은색 막대) 브랜드가 없는 범용 창;
  • 하단: 단어 단위 자막(말하는 단어가 브랜드 색상으로 표시됨);
  • 끝: "팔로우 해주세요" 카드.

비디오는 코드(Python + ffmpeg)로 조립됩니다. AI 비디오 생성기를 사용하지 않습니다. 40초 Reel은 1분 이내에 완성됩니다.

항상 사용자의 언어(일반적으로 포르투갈어)로 응답하세요.

1단계: 요청 이해 (한 번의 질문으로, 누락된 모든 것)

사용자가 아직 말하지 않은 것만 한 번에 질문하세요:

  1. 주제: 시청자가 무엇을 배우거나 테스트하게 될까요? 사용자가 이미 나레이션 텍스트를 가져온 경우 해당 텍스트를 사용하세요.
  2. 브랜드: 기본 색상(16진수, 예: #7C3AED)과 프로필 @입니다. 답변이 없으면 보라색 #7C3AED 및 @seuperfil을 사용하고 알리세요.

사용자가 "알아서 해줘"라고 말하면 묻지 말고 기본값을 사용하고 어떤 값을 사용했는지 알리세요.

2단계: 스크립트 작성

roteiro.json 파일을 만드세요(아래 형식; 준비된 템플릿은 exemplos/roteiro-exemplo.json에 있음).

작동하는 구조(58개 장면, 3060초):

  1. 갈고리 (! 표시): 시청자가 알아볼 수 있는 상황, 나레이션 10단어 이내.
  2. 번호 매겨진 단계 (1, 2, 3... 표시): 장면당 하나의 작업, 창에 작업 표시.
  3. 주의 (단계 중 하나일 수 있음): 결과 확인 및 민감한 데이터 붙여넣지 않기.
  4. 행동 촉구 (✓ 표시): 예: 포스트잇(nota)과 함께 "자막에 프롬프트".
  5. 마지막 ("tipo": "final"): "더 많은 정보를 위해 팔로우 해주세요...".

콘텐츠 규칙:

  • 최대 6단어 제목. *별표*로 1~2개 단어 강조.
  • 나레이션: 초당 약 2.3단어. 각 장면의 길이는 나레이션에서 결정됩니다.
  • 가상의 데이터, 이름 및 회사("사람 A", "공급업체")를 사용하고 데이터가 있는 장면에 "exemplo": true를 표시하세요.
  • 실제 도구의 이름, 로고 또는 화면을 넣지 마세요. 창은 일반적입니다("AI 어시스턴트", "스프레드시트", "받은 편지함").
  • 기능, 공식, 숫자 또는 결과를 지어내지 마세요. 스크립트가 도구의 기능을 언급하는 경우 공식 출처(가능하면 웹 검색)에서 확인하고 확인한 내용을 사용자에게 알리세요. 확인할 수 없으면 알리세요.
  • 과장된 약속("10시간 절약", "더 이상 안 함")을 하지 마세요.

3단계: 비디오 전 테스트 프레임

각 장면 중간 시간(시간은 출력 시작 부분에 나타남)으로 미리보기를 실행하세요:

python3 <스킬-폴더>/scripts/reel.py roteiro.json --out saida --preview 3,10,18,25,32

saida/previa_grade.jpg를 열고 확인하세요:

  • 창 밖으로 나가는 텍스트 없음;
  • 2줄을 초과하는 제목 없음;
  • 강조 표시와 블러 막대가 올바른 위치에 있는지.

필요하면 JSON을 조정하고 반복하세요. 그런 다음 사용자에게 그리드와 스크립트를 표(장면, 표시 내용, 나레이션, 시간)로 보여주고 비디오를 생성해도 되는지 물어보세요.

4단계: 비디오 생성

python3 <스킬-폴더>/scripts/reel.py roteiro.json --out saida --nome meu-reel

명령어가 생성하는 파일:

  • saida/meu-reel-sem-voz.mp4: 스크립트 자체에서 생성한 차분한 배경 음악과 키보드 사운드 포함(타사 음악 없음);
  • saida/guia-narracao.txt: 장면당 한 단락씩, 음성으로 말할 텍스트만 포함;
  • saida/tempos.txt: 각 장면의 시작과 끝 시간.

--sem-musica를 사용하여 배경 음악 없이 비디오를 생성하세요.

사용자에게 전달:

  • 비디오;
  • 나레이션 가이드 및 시간;
  • 게시물 자막(갈고리, 단계별, 전체 프롬프트(있는 경우), "예시입니다." 및 해시태그 3~5개).

보내기 전에 최종 MP4의 4~5개 프레임을 확인하세요(ffmpeg으로 추출).

5단계: 음성 (사용자가 오디오를 보낼 때)

사용자는 가이드에 따라 나레이션을 녹음합니다(휴대폰에서 직접 또는 원하는 경우 AI 음성 사용). 파일을 보내면:

python3 <스킬-폴더>/scripts/reel.py roteiro.json --out saida --nome meu-reel --audio /경로/음성.m4a
  • 시간 표시가 없으면 스크립트가 각 장면의 단어 비율에 따라 오디오 길이에 장면을 분산합니다.
  • 정확한 동기화를 위해 JSON에 "marcas_audio": [0, 7.8, 15.2, ...]를 넣고 녹음에서 각 장면이 시작되는 초를 입력하세요. 사용자가 이 시간을 말해주거나, 단어별 시간이 있는 전사 도구가 있으면 파일을 들을 수 있습니다.
  • 결과는 saida/meu-reel-com-voz.mp4이며, 음성 아래에 배경 음악이 더 작게 들립니다.

다른 옵션: 사용자가 비디오 편집기(CapCut, InShot, Instagram 편집기)에서 직접 음성을 추가할 수 있습니다(음성 없는 비디오 사용).

전달 시 알림: AI로 생성된 음성, 이미지 또는 비디오가 있는 경우 사용자는 게시할 때 AI 라벨을 표시해야 합니다.

roteiro.json 형식

{
  "marca": {"cor": "#7C3AED", "arroba": "@seuperfil", "bio": "프로필 짧은 문구"},
  "palavras_por_segundo": 2.3,
  "cenas": [
    {"selo": "!", "titulo": "받은 편지함 *가득 참?*", "narracao": "...", "exemplo": false,
     "duracao": 6.5,
     "janela": {"tipo": "lista", "...": "..."},
     "nota": {"texto": "자막에 프롬프트 ↓", "sub": "저장", "em": 0.4},
     "pilula": {"texto": "끌 수 있음", "em": 0.3, "y": 0.4}}
  ]
}
  • duracao는 선택 사항: 없으면 나레이션에서 길이가 결정됩니다.
  • 마지막 카드는 @의 첫 글자를 표시합니다. 사용자가 요청하지 않으면 마스코트를 넣지 마세요.
  • nota(포스트잇)와 pílula(떠 있는 레이블)는 선택 사항입니다. em 값은 장면 내에서 나타나는 비율입니다(0~1).
  • 흰색 배경에서 텍스트를 읽기 어려운 경우 색상이 자동으로 어두워집니다.

창 텍스트 표시: [[구간]]은 장면 중에 나타나는 강조 표시가 됩니다. {{구간}}은 구간(민감한 데이터)을 덮는 검은색 블러 막대가 됩니다.

tipo용도필드
lista받은 편지함, 할 일 목록, 파일titulo, itens([발신자, 제목, 미리보기]), nao_lidas(인덱스), destaque(인덱스), tremer, destaque_em
texto대화, 메모, 문서titulo, resumo({titulo, linhas}), resumo_animado, mensagens([{autor, texto}]), marcar_em, tarjar_em, etiquetas(✓가 있는 레이블), etiquetas_em
chatAI 어시스턴트(어두운 창)titulo, prompt(입력됨), resposta(줄 목록, 선택 사항), caracteres_por_segundo
escrever이메일 또는 메시지 답장titulo, texto(입력됨), botao
planilha간단한 표titulo, colunas, linhas, coluna_destaque, formula(선택 사항, 확인된 공식만), revelar_ultima
cartao강조 표시된 뉴스, 규칙 또는 요약selo, titulo(*강조* 허용), texto, fonte(정보 출처)
final"팔로우 해주세요" 카드bio, botao, clique_em

일반적인 문제

  • "ffmpeg를 찾을 수 없습니다": 스크립트가 pip를 통해 imageio-ffmpeg를 자동으로 설치하려고 시도합니다. 실패하면 pip install imageio-ffmpeg(필요한 경우 --break-system-packages 포함)를 실행하세요.
  • 텍스트가 잘리거나 창 밖으로 나감: 텍스트를 줄이거나, 두 개의 메시지로 나누거나, 목록 항목 수를 줄이세요(약 5줄까지 가능).
  • 자막이 너무 빠름: 장면의 duracao를 늘리거나 나레이션 단어를 줄이세요.
  • 폰트: Inter 및 JetBrains Mono(SIL Open Font 라이선스, assets/fonts에 파일 있음).

Individual skills in this repo

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

관련 스킬