Communitygithub.com

minara-guide-video

운영자가 제공한 화면 녹화로 Minara 제품 가이드/튜토리얼 비디오를 제작합니다. /minara-guide-video, "给录屏加字幕配音", 새로운 녹화 컷 재타이밍, 타임라인 승인 플레이어 구축, 또는 캡션/제품 의미 수정에 사용합니다.

minara-guide-video란 무엇인가요?

이 스킬은 Minara 제품의 실제 화면 녹화본을 전문적인 튜토리얼 비디오로 변환하는 AI 에이전트 워크플로우입니다. 운영자가 제공한 화면 녹화를 분석하고, 음성 해설과 캡션을 추가하며, 최종 MP4 파일을 로컬로 제공합니다. 주요 기능: 소스 분석, 타임라인 재구성, 프레임 추출(3~5초 간격, 전환 구간 0.5~1초), 간결한 문장으로 화면 설명, 캡션-녹화 스킬과 연동한 준비 및 렌더링, 승인 게이트(플레이어 페이지)를 통한 검증, 출력 프레임 추출 및 품질 확인. 이 스킬은 Cursor, Claude Code 등 AI 코딩 에이전트 환경에서 동작하며, 특히 `caption-recording` 스킬을 의존하여 캡션 타이밍과 렌더링을 처리합니다. 승인 게이트가 핵심으로, 렌더링 전 운영자의 확인을 필수로 요구하며, 오디오/비디오 동기화 및 제품 의미 정확성을 보장합니다. 합성 HyperFrames 마케팅 비디오에는 사용하지 않으며, 오직 실제 Minara 화면 녹화만 처리합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/OliviaPp8/minara-video-skills/tree/HEAD/skills/minara-guide-video

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

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

문서

minara-guide-video은(는) 무엇을 하나요?

실제 Minara 화면 녹화에 사용합니다. 운영자가 제품을 녹화하면 상세하면서도 간결한 영어 음성 해설과 캡션을 추가합니다. 모든 기계적 작업은 caption-recording 스킬을 불러와 따릅니다.

필수 순서

  1. 새 소스를 조사합니다. 이전 워크스루와 비슷해 보여도 타임라인을 재구성합니다.

  2. 35초마다 프레임을 추출하고, 모든 전환 주변은 0.51초 간격을 사용합니다. 각 화면/패널 경계에 방어 가능한 타임스탬프가 생길 때까지 반복합니다.

  3. 화면 순서대로 짧은 문장을 작성합니다. 보이는 작업과 확인된 제품 의미를 설명합니다. 인접한 컨트롤 간의 관계를 추론하지 마십시오.

  4. 모든 플랫 큐에 명시적인 start 앵커를 사용합니다. 다음을 실행합니다:

    python ~/.claude/skills/caption-recording/scripts/caption_footage.py <video_dir> --prepare-only
    python ~/.claude/skills/caption-recording/scripts/make_review_page.py <video_dir> --open
    
  5. 플레이어 검토 페이지에서 멈추고 운영자의 확인을 기다립니다. 타임라인이 그럴듯해 보인다고 MP4를 인코딩하지 마십시오.

  6. 모든 큐/시간/제품 사본 수정을 적용하고 준비된 타이밍을 새로고침합니다.

  7. 승인 후에만 caption_footage.py <video_dir>을 실행하여 렌더링합니다.

  8. 각 큐 중간점에서 출력 프레임을 추출합니다. 조정된 모든 큐에 대해 시작과 끝 근처도 검사합니다. 화면, 캡션, 음성 중 어느 하나라도 어긋나면 수정하고 렌더링/검사 루프를 반복합니다.

  9. MP4를 로컬로 제공하고 요청 시 Finder에서 강조 표시합니다.

플레이어 페이지는 선택적 사후 렌더링 액세서리가 아닌 엄격한 승인 게이트입니다. 기본적으로 원시 소스에 오버레이되어 계획된 큐를 실시간으로 보여주고, 내레이션 공백을 노출하며, 정밀 탐색과 속도 조절을 지원하고, 큐별 피드백을 채팅에 복사합니다.

복사 규칙

  • 실무자 언어와 TTS에 안전한 짧은 문장을 사용합니다.
  • 그 순간 실제로 보이는 것을 이름으로 지정합니다.
  • 제품 의미를 확인합니다. 예를 들어, 수익 공유율은 정산 일정이 아닌 크리에이터의 몫을 변경합니다. 구독자 개요는 크리에이터 구독자, AUM 및 수익 공유를 보고하며, 라이브 실행 컨트롤과는 독립적입니다.
  • 사용자가 지정한 음성 속도는 일반 기본값보다 우선합니다.

전달 규칙

기본적으로 어떤 채팅, 채널 또는 그룹에도 비디오를 보내지 않습니다. 현재 작업에서 운영자가 명시적으로 요청할 때만 보냅니다. 보내지 말라고 하면 이를 절대적으로 따릅니다.

Individual skills in this repo

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

OliviaPp8/minara-video-skills

Generate background music and synced sound effects for Minara videos from the per-second script. Translates each scene's mood and on-screen actions (taps, typing, success, notifications, transitions) into a cue sheet, then renders BGM + SFX locally (numpy synth, no external service), with optional ducking under the voiceover. Use for /minara-music, "配乐", "生成音乐", "BGM", "按脚本生成音乐", "加音效", or when a minara-video / minara-guide-video project needs a music bed.

OliviaPp8/minara-video-skills

Make Minara use case / beginner tutorial videos (mobile App or desktop), rebuilding the product UI in HyperFrames code and walking through the real user path step by step. Unlike minara-video (marketing demo, UI redesign allowed), this skill requires a faithful UI: copy, layout, components, and interaction paths all follow the product frontend code and screen recordings. Triggers: "use case 视频", "教程视频", "操作演示", "新手教程", "按 App 界面做一个视频"; also makes covers for these videos ("封面", "cover", "缩略图").

OliviaPp8/minara-video-skills

Write Minara video scripts before any animation work — launch / promo films, single-scene supplements, use case tutorials. Turns a brief, product screenshots, frontend code, Figma frames or a feature note into an English-only script doc built around a keyframe sheet; each keyframe has a still image (rendered from UI code, exported from Figma, or AIGC-generated from screenshots), a picture description, the voiceover line, on-screen text (花字) with style, timing and duration, and the BGM style / sound cues. Also covers what each scene must land, user flow + UI copy, voiceover word budget and open questions, in a calm, neutral, natural voice. Then hands off to minara-video, minara-usecase-video and minara-music. Use for /minara-videoscript, "写视频脚本", "视频脚本", "分镜脚本", "关键帧", "关键帧脚本", "花字", "补充脚本", "旁白稿", "video script", "voiceover script", "keyframes".

OliviaPp8/minara-video-skills

The operator's standard workflow for making Minara marketing / launch / demo videos. Built on the hyperframes skill, with a stricter process - confirm style → high-level storyboard → copy → build each scene separately → confirm a per-second script → iterate on a local test page → render only once the user is satisfied.

관련 스킬