Communitygithub.com

minara-guide-video

Cria vídeos de guia/tutorial do produto Minara a partir de gravações de tela fornecidas pelo operador. Use para /minara-guide-video, “给录屏加字幕配音”, reajustar um novo corte de gravação, criar um player de aprovação de linha do tempo, ou corrigir legenda/significado do produto. Conduz a legenda-gravação desde a análise da fonte até a aprovação pré-renderização, verificação final e entrega local. Não é para vídeos sintéticos de marketing HyperFrames.

O que é minara-guide-video?

Esta skill é projetada para o assistente de IA (Claude Code, etc.) criar vídeos de guia/tutorial do produto Minara a partir de gravações de tela fornecidas pelo operador. Ela é útil para automatizar o processo de adicionar narração e legendas a gravações de tela reais do produto, garantindo precisão e consistência. A skill suporta plataformas como Claude Code, Cursor e Codex, e é acionada por comandos como /minara-guide-video ou “给录屏加字幕配音”. O fluxo de trabalho envolve analisar a nova gravação, extrair quadros-chave, escrever frases curtas na ordem da tela, preparar a linha do tempo com âncoras de início explícitas, gerar uma página de revisão para aprovação do operador e, após aprovação, renderizar o MP4 final. A skill enfatiza a verificação contínua de cada imagem, legenda e narração, e a entrega local do arquivo, sem enviá-lo automaticamente para chats ou grupos.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que minara-guide-video faz?

Use isto para gravações de tela reais do Minara. O operador grava o produto; adicione uma narração e legendas detalhadas, mas concisas, em inglês. Carregue e siga a skill caption-recording para todos os mecanismos.

Sequência obrigatória

  1. Analise a nova fonte. Reconstrua sua linha do tempo mesmo que um tutorial antigo pareça semelhante.

  2. Extraia quadros a cada 3–5 segundos; use espaçamento de 0,5–1 segundo ao redor de cada transição. Repita até que cada limite de tela/painel tenha um timestamp defensável.

  3. Escreva frases curtas na ordem da tela. Explique a tarefa visível e o significado verificado do produto. Não infira relações entre controles próximos.

  4. Use âncoras start explícitas para cada dica plana. Execute:

    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. Pare na página de revisão do player e aguarde a confirmação do operador. Não codifique o MP4 apenas porque a linha do tempo parece plausível.

  6. Aplique cada correção de dica/tempo/cópia do produto e atualize o timing preparado.

  7. Somente após a aprovação, execute caption_footage.py <video_dir> para renderizar.

  8. Extraia um quadro de saída no ponto médio de cada dica. Para cada dica ajustada, também inspecione perto de seu início e fim. Corrija e repita o loop de renderização/verificação se alguma tela, legenda ou narração desviar.

  9. Entregue o MP4 localmente e destaque-o no Finder quando solicitado.

A página do player é um ponto de aprovação obrigatório, não um acessório opcional pós-renderização. Ela pré-visualiza a fonte bruta, sobrepõe a dica planejada ao vivo, expõe lacunas de narração, suporta busca fina e velocidade, e copia feedback específico da dica de volta para o chat.

Regras de cópia

  • Use linguagem prática e frases curtas seguras para TTS.
  • Nomeie o que está realmente visível naquele momento.
  • Verifique a semântica do produto. Por exemplo, a taxa de participação nos lucros altera a parte do criador, não o cronograma de liquidação; o Relatório de Inscritos relata os inscritos do criador, AUM e participação nos lucros, independente dos controles de execução ao vivo.
  • Uma velocidade de voz especificada pelo usuário substitui o padrão normal.

Regra de entrega

Não envie vídeos para nenhum chat, canal ou grupo por padrão. Envie apenas quando o operador solicitar explicitamente na tarefa atual. Se eles disserem para não enviar, trate isso como absoluto.

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.

Habilidades Relacionadas