Communitygithub.com

OliviaPp8/minara-guide-video

Crée des vidéos de guide produit / tutoriel Minara à partir d'enregistrements d'écran fournis par l'opérateur.

Qu'est-ce que minara-guide-video ?

Cette compétence permet de transformer des enregistrements d'écran bruts de Minara en vidéos de guide produit ou tutoriel professionnelles, avec voix off et sous-titres synchronisés. Elle est conçue pour les flux de travail réels où l'opérateur capture l'écran, et le skill ajoute une narration concise en anglais avec des sous-titres. Le processus suit une séquence rigoureuse : analyse de la source, extraction d'images tous les 3 à 5 secondes, rédaction de phrases courtes dans l'ordre des écrans, utilisation de scripts Python pour la préparation des sous-titres et la génération de la page de révision. Un point d'arrêt obligatoire est imposé sur la page de révision pour obtenir l'approbation de l'opérateur avant le rendu final. Après validation, le rendu produit un MP4 local, et une boucle de vérification assure la qualité de chaque image et sous-titre. Le skill applique des règles strictes de copie (langage pratique, phrases courtes adaptées à la synthèse vocale) et de livraison (pas d'envoi automatique de vidéos, uniquement sur demande explicite). Il ne convient pas pour les vidéos marketing synthétiques HyperFrames.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait minara-guide-video ?

Utilisez cette compétence pour les enregistrements d'écran réels de Minara. L'opérateur enregistre le produit ; ajoutez une voix off et des sous-titres détaillés mais concis en anglais. Chargez et suivez la compétence caption-recording pour tous les mécanismes.

Séquence requise

  1. Sondez la nouvelle source. Reconstruisez sa timeline même si une ancienne démonstration semble similaire.

  2. Extrayez des images toutes les 3 à 5 secondes ; utilisez un espacement de 0,5 à 1 seconde autour de chaque transition. Répétez jusqu'à ce que chaque limite d'écran/panneau ait un timestamp défendable.

  3. Écrivez des phrases courtes dans l'ordre des écrans. Expliquez la tâche visible et le sens vérifié du produit. N'inférez pas les relations entre les commandes voisines.

  4. Utilisez des ancres start explicites pour chaque repère plat. Exécutez :

    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. Arrêtez-vous à la page de révision du lecteur et attendez la confirmation de l'opérateur. N'encodez pas le MP4 simplement parce que la timeline semble plausible.

  6. Appliquez chaque correction de repère/temps/copie produit et rafraîchissez le timing préparé.

  7. Uniquement après approbation, exécutez caption_footage.py <video_dir> pour effectuer le rendu.

  8. Extrayez une image de sortie au point médian de chaque repère. Pour chaque repère ajusté, inspectez également près de son début et de sa fin. Corrigez et répétez la boucle rendu/vérification si un écran, un sous-titre ou une voix dérive.

  9. Livrez le MP4 localement et mettez-le en évidence dans le Finder lorsque demandé.

La page du lecteur est une porte d'approbation stricte, pas un accessoire optionnel post-rendu. Elle utilise par défaut la source brute, superpose le repère planifié en direct, expose les lacunes de narration, prend en charge la recherche fine et la vitesse, et copie les commentaires spécifiques aux repères dans le chat.

Règles de copie

  • Utilisez un langage pratique et des phrases courtes compatibles avec la synthèse vocale.
  • Nommez ce qui est réellement visible à ce moment précis.
  • Vérifiez la sémantique du produit. Par exemple, le taux de partage des bénéfices modifie la part du créateur, pas le calendrier de règlement ; Subscriber Overview rapporte les abonnés du créateur, les actifs sous gestion et le partage des bénéfices, indépendamment des contrôles en direct.
  • Une vitesse de voix spécifiée par l'utilisateur remplace la valeur par défaut.

Règle de livraison

N'envoyez pas de vidéos dans un chat, un canal ou un groupe par défaut. Envoyez uniquement lorsque l'opérateur le demande explicitement dans la tâche en cours. S'il dit de ne pas envoyer, traitez cela comme absolu.

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.

Skills associés