Communitygithub.com

daniel-video-annotate

화면 녹화를 설명된 버전으로 변환합니다. 정적인 대기 구간을 제거하고, 각 주요 동작에서 일시 정지하며, 컨트롤을 사각형으로 강조하고, 수행한 작업과 이유를 자막으로 표시합니다.

daniel-video-annotate란 무엇인가요?

이 스킬은 화면 녹화 영상을 입력받아, 불필요한 대기 시간을 제거하고 각 주요 단계별로 설명 자막과 강조 상자를 추가한 '설명 영상'을 생성합니다. 사용자가 `/daniel-video-annotate` 명령어를 호출하거나 영상에 주석 또는 설명을 요청할 때 활성화됩니다. Python 표준 라이브러리와 ffmpeg만을 사용하며, Claude Code, Cursor, Codex 등 AI 에이전트 환경에서 동작합니다. 작업 과정은 7단계로 구성되며, 사용자의 읽기 속도나 고정 정지 시간을 설정하고, 영상 내 정적 구간을 자동으로 잘라낸 후 각 동작의 프레임과 컨트롤 박스를 찾아 한 문장의 자막을 추가하여 최종 영상을 렌더링합니다. 모든 단계를 검증하고 오류 발생 시 상세한 해결 방법을 제공합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/dancodes/skills-agents/tree/HEAD/skills/daniel-video-annotate

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

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

문서

/daniel-video-annotate

입력: 비디오 파일과 각 단계를 수행하는 이유(티켓, 머지 리퀘스트, 사용자의 메시지). 출력: 입력과 함께 <name>-trimmed.mp4와 <name>-explained.mp4가 생성됩니다. 입력 파일은 절대 변경되지 않습니다.

설명 영상은 녹화를 재생하고, 각 일시 정지 시점에서 한 프레임을 정지 시간 동안 유지하며, 하나의 박스 처리된 컨트롤 주변 화면을 어둡게 하고, 녹화 영상 아래 또는 위에 검은색 막대에 한 문장의 자막을 표시합니다. 이 막대는 비디오를 더 길게 만들 뿐 녹화 영역을 가리지 않습니다.

annotate.py는 이 파일과 같은 위치에 있습니다. 아래 명령어에서 A는 python3 "${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills/daniel-video-annotate/annotate.py"를 나타냅니다. 이 스크립트는 ffmpeg, ffprobe 및 Python 표준 라이브러리만 필요로 합니다. <work>는 스크래치 폴더입니다. 세션 스크래치패드가 있으면 그곳을, 없으면 ${TMPDIR:-/tmp}/video-annotate/<name>/를 사용합니다.

비디오가 개발 VM에 있는 경우, 먼저 dvm get <remote path> <local dir>로 로컬에 복사하세요.

0. 읽기 속도 선택

정지 시간(hide)은 각 자막이 화면에 읽힐 수 있도록 유지되는 시간입니다. 각 일시 정지는 읽기 속도에 따라 자막을 읽는 시간에 1.5초를 더하고, 최소 2.5초 동안 유지됩니다. 사용자가 지정한 분당 단어 수(wpm)를 사용하고, 지정하지 않은 경우 350wpm을 사용합니다. 묻지 마세요. 사용자가 초 단위로 고정 정지 시간을 지정한 경우, 모든 일시 정지에 해당 시간을 사용합니다.

읽기 속도 또는 고정 정지 시간이 결정되면 완료됩니다.

1. 대기 구간 자르기

A trim <video> <name>-trimmed.mp4

이 명령어는 화면이 1.5초 이상 정지된 모든 구간을 찾아 각 구간의 첫 1초를 유지하고 나머지를 잘라냅니다. 잘라낸 구간의 수와 전후 길이를 출력합니다. 사용자가 대기 구간을 유지하기를 원하는 경우 이 단계를 건너뛰고 원본을 <trimmed>로 사용합니다.

이후 모든 시간은 <trimmed>의 시간을 기준으로 합니다. 다시 자르면 모든 시간이 변경되므로, 새로 자른 후에는 2단계부터 6단계까지 다시 수행해야 합니다.

2. 스토리 파악하기

A sheets <trimmed> <work>/sheets

이 명령어는 초당 한 프레임씩, 6개의 프레임으로 구성된 콘택트 시트를 생성하며 각 프레임에 정확한 시간이 표시됩니다. 모든 시트를 읽으십시오. 각 단계의 이유를 파악하기 위해 티켓이나 다른 출처를 읽으십시오.

화면에서 사람이 무엇을 하는지, 각 동작이 어떤 값을 설정하는지, 그리고 어떤 결과가 녹화의 목적을 증명하는지 순서대로 말할 수 있을 때 완료됩니다.

3. 일시 정지 선택

각 선택(값 선택, 버튼 누름, 의도적으로 페이지 열기)과 목적을 증명하는 각 결과에 대해 한 번씩 일시 정지합니다. 결정을 수반하지 않는 탐색은 건너뜁니다.

각 일시 정지에 대해 프레임과 박스를 찾습니다.

A frames <trimmed> <work>/frames 23.0 23.2 23.4 23.6

이 명령어는 시간당 하나의 전체 크기 PNG 파일을 생성하며, 파일 이름에 정확한 시간이 표시되고 100픽셀 간격의 빨간색 그리드와 상단 및 왼쪽 가장자리를 따라 픽셀 좌표 레이블이 표시됩니다.

  • 안정된 프레임 선택: 녹화에는 클릭 후 몇 프레임 동안 패널이 비어 있는 등 절반만 렌더링된 프레임이 포함될 수 있습니다. 컨트롤과 주변 영역이 완전히 그려질 때까지 0.2초 간격으로 살펴봅니다.
  • 목록에서 선택: 목록이 열리고 커서가 옵션 위에 있는 프레임을 선호합니다. 해당 프레임이 절반만 렌더링된 경우, 필드에 새 값이 표시되는 바로 다음 프레임을 사용합니다.
  • 박스 읽기: 그리드 레이블에서 [x, y, width, height] 형식으로 소스 픽셀 단위로 읽습니다. 읽기 도구는 큰 이미지를 축소하므로, 표시된 이미지에서 측정한 위치는 잘못됩니다. 레이블은 정확합니다.
  • 컨트롤 박스 지정: 자막이 설명하는 단일 컨트롤을 약간의 여백을 두고 박스 처리합니다. 박스를 생략할 수도 있으며, 그 경우 아무것도 어두워지지 않습니다.

각 일시 정지에 대해 직접 살펴본 프레임의 시간과, 동일한 프레임에서 읽은 박스가 있으면 완료됩니다.

4. 자막 작성

일시 정지당 한 문장입니다. 무엇을 하고 왜 하는지, 또는 화면에 무엇이 표시되고 왜인지를 설명합니다. 구체적인 대상을 언급하세요: 행, 필드, 이전 값과 새 값.

관련 스킬