Communitygithub.com

video-caricatura-social

주제를 바탕으로 최대 60초의 9:16 세로형 비디오(Reels, TikTok, Shorts)를 생성합니다. 인간적이고 공감 가는 스크립트, 캐리커처/일러스트 장면, 단어별 황금색 자막, 우측 하단 브랜드 워터마크, 문의 유도 엔딩 화면과 게시글 본문을 함께 제공합니다.

video-caricatura-social란 무엇인가요?

이 스킬은 사용자의 주제(예: 정서적 고통, 메시지, 콘텐츠)를 바탕으로 Instagram Reels, TikTok, YouTube Shorts에 바로 게시할 수 있는 최대 60초 길이의 9:16 세로형 비디오를 제작합니다. 주된 특징은 부드러운 움직임이 있는 일러스트 장면, 단어별로 나타나는 황금색 자막, 우측 하단의 브랜드 워터마크, 그리고 문의 유도 엔딩 화면입니다. 인간적이고 공감 가는 톤의 스크립트와 게시글 본문도 함께 생성합니다. @dredsonbarroso의 Reel 스타일(판타지 그림, 작은 인물과 큰 풍경, 황금색 세리프 자막, 감성적인 나레이션)을 참고하되, 등장인물을 사용자가 제공한 사진을 기반으로 한 캐리커처로 대체하고 색상과 배경은 사용자의 입력에 따라 맞춤화합니다. 이 스킬은 Claude Code, Codex, Manus에서 동작하며, 사용 가능한 이미지 생성 도구(Adobe Firefly, Figma, Gamma, 또는 플랫폼 내장 도구)를 우선 활용하거나, 생성 도구가 없으면 사용자에게 이미지 제작을 요청할 수 있는 프롬프트 스토리보드를 제공합니다. 최종 비디오는 ffmpeg 기반 스크립트로 조립되며 60초 제한이 적용되어 규정을 초과하지 않도록 보장합니다. 또한 의료 광고 규정(CFM 결의안 2336/2023)을 준수하고, 자살 위험 주제에 대한 적절한 경고를 포함하는 등 윤리적이고 법적 지침을 따르도록 설계되었습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ebarroso12/skillsvideoredesocial/tree/HEAD/skills/video-caricatura-social

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

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

문서

소셜 미디어용 캐리커처 비디오 (최대 60초)

주제(고통, 메시지, 콘텐츠)를 게시 준비가 완료된 세로형 비디오로 변환합니다: 부드러운 움직임이 있는 일러스트 장면, 단어별 황금색 자막, 우측 하단의 브랜드 워터마크, 문의 유도 엔딩 화면. 함께 인간미 있고 공감 가는 톤의 게시글 본문도 제공됩니다.

참고 스타일은 @dredsonbarroso의 Reel (판타지 그림, 큰 풍경 앞의 작은 인물, 황금색 세리프 자막, 감성적인 나레이션)이며, 한 가지 차이점이 있습니다: 등장인물은 사용자(또는 선택한 다른 인물)의 캐리커처가 되고, 색상과 배경은 사용자의 입력에 따라 결정됩니다.

최종 결과물

  1. video_final.mp4 — 1080x1920, 30fps, H.264 + AAC, 재생 시간 ≤ 60초 (스크립트에서 제한).
  2. legenda.txt — 게시글 본문: 공감 텍스트 + 문의 유도 문구 + 주소/연락처 + 해시태그.
  3. 스크립트 및 이미지 프롬프트 (사용자가 다시 만들거나 조정할 수 있음).

진행 순서

주어진 순서대로 진행하세요. 부족한 부분만 물어보세요. 사용자가 이미 주제, 인물, 분위기를 알려주었다면 질문을 반복하지 말고 바로 시작하세요.

0. 브리핑 (부족한 부분만)

알아야 할 사항사용자가 말하지 않은 경우
비디오가 다루는 주제 / 고통 (예: 외로움, 불안, 돌봄 피로)물어보세요 — 핵심입니다
인물: (a) 사용자 자신의 캐리커처 (사진 필요), (b) 다른 잘 알려진 인물/캐릭터, (c) 오리지널 캐릭터(c)로 가정하고 가정했다고 알리세요
색상 및 배경 (분위기, 장면, 시대, 팔레트)주제에서 유추하여 한 줄로 선언하세요
음성: 사용자 녹음, 환경의 TTS, 또는 자막 + 음악만자막만 (+ 음악이 전송된 경우)
재생 시간35~50초 (한도는 60초이며 절대 초과하지 마세요)

1. 스크립트

references/roteiro-empatico.md를 따라 스크립트를 작성하세요 (구조: 후크 → 고통 → 위로 → 의사의 관점 → 초대; 40초 기준 약 100단어). 비디오 자막은 스크립트 그 자체이며, 짧은 문장으로 장면당 하나의 아이디어를 담습니다. 스크립트를 스토리보드(2단계)와 함께 사용자에게 보여주고, 사용자가 변경을 요청하지 않는 한 계속 진행하세요.

2. 스토리보드 및 "인물 카드"

  • 각 47초 분량의 장면 59개 (엔딩 화면 4.5초는 스크립트에 의해 추가됨).
  • 인물 카드(고정된 특징: 머리카락, 안경, 수염, 피부 톤, 옷, 색상)를 작성하고 모든 프롬프트에 포함시켜 장면 간 얼굴이 바뀌지 않도록 하세요. 모델은 references/prompts-imagem.md 참조.
  • 구성 규칙: 인물은 상단 1/3 또는 중앙에 배치하고 하단 1/3은 비워 자막이 들어갈 공간을 확보하세요. 우측 하단은 워터마크를 위해 깨끗하게 유지하세요.

3. 이미지 (캐리커처 / 그림)

환경이 제공하는 것을 다음 순서로 확인하세요:

  1. 사용자가 보낸 이미지 (사진 또는 아트워크): 직접 사용하거나, 사진을 참조하여 이미지 생성기로 캐리커처/그림으로 변환합니다.
  2. 사용 가능한 이미지 생성기: Claude에서는 커넥터를 검색하세요(SearchMcpRegistry/ToolSearch "image generation" 사용; Adobe Firefly, Figma, Gamma 등의 옵션이 있음); Codex 및 Manus에서는 내장 이미지 생성 도구를 사용하세요. 일괄 생성 전에 도구가 크레딧을 소모하는 경우 사용자에게 알리세요.
  3. 생성기 없음: 번호가 매겨진 프롬프트가 포함된 스토리보드를 제공하고 사용자에게 이미지(cena_01.png, cena_02.png...)를 생성/전송하도록 요청하세요. 그런 다음 계속 진행합니다.

먼저 하나의 테스트 이미지(장면 1)를 생성하여 얼굴과 스타일을 확인한 후 나머지를 생성하세요. 형식 9:16 (예: 1080x1920 또는 더 큼). 다른 비율로 오는 경우 스크립트가 흐린 배경을 추가합니다.

캐릭터: 아래 "캐릭터 규칙" 및 references/personagens-conhecidos.md를 참조하세요.

4. 편집

project.json을 만들고(templates/project.example.json 템플릿 사용) 이 스킬이 설치된 폴더(이 SKILL.md가 포함된 폴더)에서 스크립트를 실행하세요:

python3 <스킬-폴더>/scripts/build_video.py project.json --check-only   # 시간 계획
python3 <스킬-폴더>/scripts/build_video.py project.json --preview      # 빠른 테스트 540x960
python3 <스킬-폴더>/scripts/build_video.py project.json                # 최종 버전

요구 사항: python3, pip install pillow, libass가 포함된 ffmpeg (대부분의 설치에서 기본값).

project.json의 주요 필드 (모든 경로는 프로젝트 폴더 기준):

필드용도
cenas[].imagem / texto장면 이미지와 자막이 될 문구
cenas[].duracao선택 사항; 없으면 단어 수로 시간 결정 (~2.6단어/초)
cenas[].movimentozoom_in, zoom_out, pan_left, pan_right, pan_up, pan_down, none
cenas[].ajusteauto (기본값), cover (자름) 또는 blur (흐린 배경)
audio.voz / audio.musica선택적 파일; 음성이 있으면 장면이 음성이 끝날 때까지 늘어남
legenda.posicao_y자막의 Y 위치(px) (기본값 1280, 하단 1/3)
marca_dagua.corauto (기본값: 대비 기준 선택), dourado, branco, azul, preto
cta.ativo / cta.duracao문의 유도 엔딩 화면 (기본값 4.5초)
post.corpo게시글의 공감 텍스트; 스크립트가 전체 legenda.txt를 구성함
max_segundos제한; 기본값 60

60초 제한: 계획이 제한을 초과하면 스크립트가 오류(코드 2)와 함께 중지되고 초과 시간을 알립니다. 음성이 없으면 --fit이 장면을 압축합니다. 음성이 있으면 텍스트를 자르고 다시 녹음하세요. 60초를 초과하는 비디오는 절대 제공하지 마세요.

5. 제공 전 확인

  • 최종 MP4 재생 시간 ≤ 60초 (스크립트가 이미 출력 및 검증함).
  • 3개의 프레임(시작, 중간, 끝)을 추출하여 확인: 자막이 배경 위에서 읽기 쉽고 얼굴을 가리지 않음; 워터마크가 우측 하단에 보임; 엔딩 화면이 완전함. ffmpeg -ss 10 -i video_final.mp4 -frames:v 1 quadro.png
  • 자막 다시 읽기: 강세 및 철자가 올바른지 확인.
  • 장면 간 캐릭터 얼굴이 일관적인지 확인.

6. 제공

MP4와 legenda.txt를 컨텍스트 한 줄과 함께 보내세요. 단 하나의 다음 작업(예: 다른 배경 또는 사용자 음성 버전)을 제안하세요. 환경에 파일 전송 도구가 있으면 사용하고, 없으면 파일 경로를 알려주세요.

캐릭터 규칙

  • 본인 캐리커처: 사용자가 보낸 사진으로만 만듭니다. 두드러진 특징(머리카락, 수염, 안경, 피부 톤, 얼굴형)을 존중하고 공감 가는 가벼운 과장으로 보존하며, 절대 조롱하지 않습니다.
  • 사적인 인물: 당사자의 동의 없이 제3자(환자, 가족)를 캐리커처하지 않습니다. 건강 콘텐츠에서는 환자 식별 이미지나 이야기를 절대 사용하지 않습니다.
  • 미성년자: 실제 어린이의 캐리커처는 금지합니다. 오리지널 캐릭터를 사용하세요.
  • 잘 알려진 인물/캐릭터: 웹에서 시각적 설명(특징, 색상, 의상)을 조사하여 영감으로 사용하세요. 공인 사진을 다운로드하거나 복사하지 마세요. 저작권으로 보호되는 캐릭터(만화, 영화, 게임)는 생성기에서 거부되는 경우가 많으며 충실히 재현해서는 안 됩니다. 영감을 받은 오리지널 원형(예: "파란 망토의 전사")을 제안하고 한 줄로 설명하세요. 실제 공인의 경우 존중하는 캐리커처를 사용하세요. 명예 훼손, 정치적 공격, 해당 인물에 대한 허위 주장은 금지됩니다. 자세한 내용은 references/personagens-conhecidos.md를 참조하세요.

브랜드 및 아이덴티티

모든 내용은 brand/brand.json 및 brand/logos/에서 가져옵니다: 이름, CRM, WhatsApp, 주소, 웹사이트, Instagram, 색상 및 워터마크(금, 흰색, 파랑, 검정 심볼)가 이미 저장되어 있습니다. 워터마크는 우측 하단(너비의 13%)에 있으며 배경과의 대비에 따라 색상이 선택됩니다. 다른 사람/클리닉과 함께 사용하려면 brand.json 및 brand/logos/의 파일을 교체하세요(이름을 유지하거나 JSON을 조정).

레이아웃 참고: Instagram에서는 측면 버튼과 게시글 본문이 우측 하단 일부를 가릴 수 있습니다. 워터마크가 가려지는 경우 프로젝트에서 marca_dagua.margem_inferior_px를 조정하세요.

정신 건강 및 의료 광고 (체크리스트)

건강 콘텐츠는 주의가 필요합니다. 제공하기 전에 다음을 확인하세요:

  • 치료나 결과에 대한 약속, "전후", 환자 증언, 원격 진단 금지.
  • 위로와 전문가 평가 초대의 언어 사용, 선정주의나 공포 금지.
  • 전문가 등록 번호 표시 (CRM은 엔딩 화면과 게시글 본문에 포함됨, 스크립트가 이미 포함함).
  • 자해나 자살 위험이 있는 주제인 경우: 방법이나 그래픽 장면을 보여주지 않음. 게시글 본문에 즉각적인 도움을 구하라는 안내(CVV 188, 24시간; 응급 상황 시 SAMU 192)를 포함하세요.
  • 현재 규정(의료 광고에 관한 CFM 결의안 2336/2023)에 의문이 있는 경우 사용자에게 CRM에 확인하라고 안내하세요. 이는 실용적인 알림일 뿐 법적 의견이 아닙니다.

일반적인 문제

증상원인 / 해결책
ffmpeg not foundffmpeg를 설치하고 터미널을 다시 여세요
황금색 세리프 글꼴이 없는 자막fonts/ 폴더가 스크립트와 함께 있어야 합니다 (스크립트를 단독으로 옮기지 마세요)
재생 시간 오류 (코드 2)스크립트가 김: 문장을 자르거나 장면을 줄이거나 --fit 사용 (음성 없음)
장면마다 얼굴이 바뀜동일한 캐릭터 카드를 재사용하고 참조 이미지로 생성하세요
워터마크가 배경과 구분되지 않음marca_dagua.cor 수동 설정 (branco/azul/dourado)
텍스트가 얼굴을 가림legenda.posicao_y를 높이거나 하단 공간이 있는 이미지로 다시 만드세요

이 스킬의 파일

  • scripts/build_video.py — 비디오 편집, 엔딩 화면, 게시글 본문, 60초 제한.
  • scripts/make_test_scenes.py — 엔진 테스트만을 위한 합성 장면 생성 (최종 아트워크 아님).
  • references/roteiro-empatico.md — 스크립트 구조, 톤, 게시글 본문 모델, 해시태그.
  • references/prompts-imagem.md — 캐릭터 카드, 스타일 블록, 장면 및 캐리커처 프롬프트.
  • references/personagens-conhecidos.md — 잘 알려진 인물 및 캐릭터 조사 및 적용 방법.
  • references/voz-e-audio.md — 나레이션 및 음악 옵션.
  • references/instalacao.md — Claude Code, Codex, Manus 및 Claude.ai 설치.
  • templates/project.example.json — 프로젝트 템플릿.
  • brand/ 및 fonts/ — 브랜드, 로고, 글꼴(Playfair Display 및 Montserrat, OFL 라이선스).

관련 스킬