Communitygithub.com

explainer

토킹헤드 클립을 설명 영상으로 편집합니다. 화자는 둥근 패널 안에 앉고 머리는 패널 위로 튀어나오며, 나머지 프레임은 시각 자료(전후 비교 화살표 또는 번호 목록)로 요점을 설명합니다.

explainer란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code 등)가 사용자의 1인 발언 클립(talking-head clip)을 전문적인 설명 영상(explainer)으로 편집할 수 있도록 돕습니다. 사용자가 "/explainer"를 실행하거나 "나를 아래에, 시각 자료는 위에" 또는 "나를 옆에, 시각 자료는 옆에" 같은 요청을 하면, 이 스킬은 자동으로 세로(1080×1920, 릴/쇼츠) 또는 가로(1920×1080, 유튜브 등) 포맷을 감지하거나 사용자가 지정할 수 있습니다. 주요 기능으로는 클립 자르기, 음성 전사(transcription)를 통한 단어별 타임라인 추출, 화자 눈높이(eye_y) 및 얼굴 위치(face_x) 측정, 전후 비교 화면(compare 타입) 또는 번호 목록(list 타입) 시각 자료 생성, 그리고 키워드 강조 캡션 추가가 있습니다. 모든 설정은 JSON 스펙 파일로 관리되며, 빌드 후 체크 시트(sheet.jpg)로 플랫폼 UI에 가려지는 영역을 확인하고 수정할 수 있습니다. 이 스킬은 ffmpeg, Node.js, Groq API(전사용)를 필요로 하며, 긴 영상의 경우 /long-form 스킬과 함께 순간(moment)으로 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alisolanki/alis-claude-editing-skills/tree/HEAD/skills/explainer

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

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

문서

/explainer

┌──────────────────────┐
│   Steal what works   │  제목, 악센트 색상 한 단어
│ [before] ⟶ [after]   │  비교: 카드, 화살표, 나타내기 (또는 번호 목록)
│      ╭──head──╮      │  머리가 패널 위로 튀어나옴
│ ╭────┴────────┴────╮ │
│ │  스피커, 자막    │ │  둥근 패널, 눈높이 = 패널 상단
│ ╰──────────────────╯ │
└──────────────────────┘

첫 사용

이 스킬의 폴더는 Claude Code가 로드할 때 표시하는 "기본 디렉토리"입니다. 키트를 이 폴더에서 확인하고(심볼릭 링크도 작동), 한 번 설정합니다:

SKILL_DIR="<this skill의 기본 디렉토리>"   # Claude Code가 "이 스킬의 기본 디렉토리"로 출력한 경로
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
PY="$KIT/.venv/bin/python"; [ -x "$PY" ] || bash "$KIT/setup.sh" --cutout

GROQ_API_KEY가 전사를 위해 설정되어 있어야 합니다 (console.groq.com에서 무료로 받을 수 있음). ffmpeg와 Node가 필요합니다.

포맷

모든 스펙은 "format"을 받습니다: "vertical" (1080×1920: 릴, 쇼츠, 세로 장편), "horizontal" (1920×1080: YouTube 및 기타 장편) 또는 "auto" (기본값: 원본 영상의 비율을 따름). "$PY" "$KIT/reel.py" probe <video>를 실행하면 auto가 무엇을 선택하는지 알 수 있습니다. 시트는 플랫폼이 가리는 영역을 빨간색으로 표시합니다: 세로에서는 Instagram/TikTok UI, 가로에서는 YouTube 플레이어 크롬. 전체 길이 비디오의 경우, 이 스킬을 직접 클립을 자르는 대신 /long-form 내의 순간(moment) 으로 사용하세요.

단계

  1. 클립. 사용자가 제공한 클립을 사용합니다 (모든 크기 가능; 1080×1920 또는 1920×1080으로 자름, 포맷 참조). 제공된 클립이 없을 때만 요청합니다.
  2. 단어. "$PY" "$KIT/reel.py" words <video>는 각 단어와 시간을 출력합니다 (첫 사용 시 전사). 한 문장씩 [ends …]와 함께 마지막 단어의 종료 시간을 출력합니다. 하나의 요점을 전달하는 3~8초 길이의 구간을 선택하되, 완전한 문장으로 구성합니다: start는 첫 단어의 시간이고 end는 마지막 문장의 [ends …] 시간입니다 (원본 비디오 초).
  3. 눈높이. "$PY" "$KIT/reel.py" frame <video> <구간 내 시간> frame.jpg를 실행한 다음 이미지를 확인합니다. 눈금자는 캔버스 픽셀 단위이며, 눈의 y 좌표를 읽습니다. 이것이 eye_y입니다 (세로: 일반 프레이밍의 경우 약 700800; 가로: 약 350450). 가로에서는 얼굴 중심의 x 좌표도 읽습니다: 이것이 face_x입니다.
  4. 스펙. 클립 옆에 <clip name>.explainer.json을 작성합니다 (필드 아래 참조). 스펙 내 경로는 스펙 파일 기준 상대 경로입니다. 모든 시간은 start로부터의 초 또는 기준이 되는 단어입니다 (예: "viral", "viral#2" (두 번째 등장), "viral+0.2"). 단어를 선호하세요: start를 이동해도 올바르게 유지됩니다.
  5. 빌드. "$PY" "$SKILL_DIR/build.py" <spec.json>을 실행합니다. 구간을 자르고, 화자를 분리하고(프레임당 약 0.1초), HyperFrames로 렌더링하고 <out>.sheet.jpg를 씁니다.
  6. 확인. 시트를 확인합니다. 빨간색은 플랫폼이 가리는 영역입니다. 다음 경우 스펙을 수정하고 다시 빌드합니다:
    • 제목이나 시각 자료가 빨간 영역에 있는 경우
    • 자막이 입을 가리거나 빨간 하단 영역에서 80px 이내인 경우 (caption_top 이동)
    • 자막이 구간 밖의 단어를 표시하는 경우 (start 또는 end를 문장 경계로 이동)
    • 머리가 패널 위로 튀어나오지 않는 경우 (eye_y 이동)
    • 이미지가 누락되었거나 찌그러진 경우
  7. 전달 mp4 경로와 각 시각 자료가 보여주는 내용을 한 줄로 설명합니다.

스펙

{
  "video": "my-clip.mp4", "start": 21.4, "end": 25.66, "out": "my-clip.speaker.mp4",
  "title": "Steal what *works*",
  "eye_y": 750,
  "visual": {
    "type": "compare",
    "left":  {"label": "Another niche", "images": ["theirs-1.jpg", "theirs-2.jpg", "theirs-3.jpg"], "at": 0.3,
              "chip": "14× viral", "chip_at": "viral", "swipe_at": ["carousel", 2.3]},
    "right": {"label": "Your niche", "at": "outside", "reveal_at": "recreate",
              "image": "my-photo.jpg", "text": "the best *ai tools*\nto use when\nyou're *young and broke*"},
    "arrow_at": "and"
  },
  "keys": ["viral", "outside", "recreate"],
  "caption_top": 1420
}
  • title: 1~4 단어. 악센트 색상을 위해 한 단어를 *...*로 감쌉니다.
  • visual.type: "compare"는 전후 비교입니다:
    • 왼쪽 카드는 1~3개의 이미지를 보여주고 swipe_at에서 이미지를 전환합니다.
    • 오른쪽 카드는 점선 "?"로 시작합니다. 화살표가 arrow_at에서 그려지고, 그 다음 카드가 reveal_at에서 나타납니다.
    • 오른쪽 카드는 단순한 image이거나, image와 text로 구성된 캐러셀 커버입니다 (*word*는 악센트 필 위에 표시되고, \n은 줄 바꿈).
  • 각 카드는 이미지 대신 텍스트 카드가 될 수 있습니다: "big": "*Pro*\ntools", "small": "what pros use". 사용자에게 이미지가 없을 때 사용합니다. 화자가 가리키는 좌우 비교에 적합한 선택입니다.
  • visual.type: "list": {"type": "list", "items": [{"text": "Find a *viral* post", "at": "find"}, ...]}. 최대 4개의 번호 행, 각각 말할 때 나타납니다.
  • keys: 악센트 필 위에 표시할 단어들. 의미를 전달하는 2~4개를 선택합니다. 단어가 말해질 때마다 강조 표시됩니다.
  • 가로 전용: face_x (패널 내 얼굴 중앙 정렬), side ("right" 기본값, 또는 "left"), scale (0.9: 화자가 그려지는 크기).
  • caption_top: 자막 상단의 y 좌표: 세로 1420 (하단이 1500 이상 유지), 가로 850 (패널 위에 위치; 하단이 960 이상 유지).

취향

  • 클립당 하나의 요점. 구간이 두 가지 요점을 포함한다면, 두 개의 explainer를 만드세요.
  • 각 시각 자료를 해당 단어가 말해지는 시점에 나타내세요. 어떤 것도 말해지기 전에 나타나서는 안 됩니다. 제목은 예외입니다: 첫 프레임부터 표시됩니다.
  • 세로: 상단 시각 자료를 y 330760 사이에 유지하세요 (제목은 그 위, 약 210에 위치). 가로: 제목은 y 110에, 시각 자료는 y 270830 사이에 패널 옆에 위치합니다. 텍스트와 그래픽은 빨간 영역 밖에 있어야 합니다. 화자 패널은 빨간 영역에 걸쳐도 괜찮습니다.
  • 화자가 왼쪽과 오른쪽을 가리키는 경우 compare를 사용하세요. 카드는 그들이 가리키는 위치에 배치됩니다.
  • 사용자 자신의 이미지를 사용하세요. 다른 사람의 게시물에 대한 숫자나 결과를 임의로 만들지 마세요. "14× viral"과 같은 칩은 사용자가 말하거나 제공한 내용이어야 합니다.

Individual skills in this repo

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

관련 스킬