Communitygithub.com

Hownameee/short-videos

Exécute la Phase 1 du workflow collaboratif de vidéos courtes : transformer un sujet ou une invite en un dossier de recherche sourcé et 2 à 4 directions vidéo distinctes, chacune avec un hook de tension défendable, une promesse, un bénéfice, des beats, une approche visuelle, une fourchette de durée et des risques. Utilisez-la quand l'utilisateur demande des idées de vidéos, des angles, des recherches, des faits, des accroches, une analyse du sujet ou des choix avant l'écriture du script. Arrêtez-vous pour que l'utilisateur choisisse une direction et ne continuez pas silencieusement vers le script ou la production.

Qu'est-ce que short-videos ?

Cette compétence est conçue pour la Phase 1 du processus de création de vidéos courtes. Elle prend une invite brute de l'utilisateur (un sujet, une idée de vidéo, une demande d'analyse) et la transforme systématiquement en un livrable structuré : un dossier de recherche avec des faits sourcés et 2 à 4 directions vidéo uniques, chacune détaillée avec hook, promesse, beats, approche visuelle, durée et risques. Elle s'arrête délibérément avant le script ou la production, forçant une décision humaine. Utile pour les créateurs de contenu, les marketeurs ou les équipes vidéo utilisant Claude Code, Cursor, Codex ou des environnements d'agents IA. Le workflow inclut la création d'un projet basé sur des artefacts, la recherche via des sources (et non la mémoire LLM), et la génération d'options vidéo différenciées. La sortie est structurée en fichiers (request.json, state.json, research.md, directions.json) et suit des contrats d'artefacts définis.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/short-video-discovery

Demander à votre IA préférée

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

Documentation

Découverte de vidéos courtes

Propriétaire de la Phase 1. Utilisez les contrats d'artefacts lors de la persistance des sorties.

Réception

Lorsque l'utilisateur démarre un nouveau workflow vidéo ou demande à réfléchir à une vidéo qu'il a l'intention de produire, parcourez d'abord les dossiers projects/<nnn>-* existants, allouez le prochain nombre complété par des zéros commençant à 001, dérivez un slug stable, créez le dossier du projet et persistez request.json plus state.json avec request_created. Réutilisez le projet fourni lors de la reprise. Ne créez pas de projet pour une discussion purement générale et en lecture seule sans intention de produire une vidéo.

Extrayez ce que l'utilisateur vous a déjà donné avant de demander quoi que ce soit :

  • sujet et résultat souhaité ;
  • public et connaissances supposées ;
  • plateforme et fourchette de durée ;
  • langue, ton, niveau de tension et objectif d'appel à l'action ;
  • affirmations, sources, médias et fournisseurs autorisés ou interdits.

Procédez avec des valeurs par défaut raisonnables pour les détails secondaires. Demandez tôt uniquement lorsqu'une réponse manquante modifierait matériellement la portée de la recherche ou la sécurité. Enregistrez les valeurs par défaut dans assumptions.

Recherche

Utilisez des sources primaires ou faisant autorité pour les affirmations qui peuvent changer ou avoir des conséquences matérielles. Distinguez :

  • un fait vérifié avec une source directe ;
  • une inférence dérivée de faits cités ;
  • un cadrage créatif ;
  • une affirmation non résolue ou rejetée.

Ne traitez pas la mémoire LLM comme une recherche web. Un LLM local tel qu'Ollama peut organiser les preuves et générer des directions, mais il a besoin d'un adaptateur de recherche, d'URLs récupérées ou d'un pack de sources fourni par l'utilisateur pour des preuves actuelles.

Construisez un pack de faits compact avec 3 à 7 affirmations utiles. Pour chaque affirmation, enregistrez l'énoncé, l'URL de la source, l'éditeur, la date si disponible, la confiance et ce qu'elle peut soutenir en toute sécurité dans la vidéo. Évitez de collecter des faits qui n'influenceront pas une direction.

Générer des directions

Créez 2 à 4 options qui diffèrent par la logique narrative, pas seulement par le libellé. Les familles utiles incluent :

  • cas d'utilisation de douleur ou d'échec ;
  • correction contrarienne d'une idée fausse réelle ;
  • démonstration résultat d'abord ;
  • analogie visuelle ;
  • comparaison ou avant/après ;
  • mini histoire avec une décision et une conséquence.

Pour chaque direction, incluez :

  1. titre de travail ;
  2. problème du public ;
  3. hook de tension ;
  4. promesse et bénéfice ;
  5. deux ou trois beats principaux ;
  6. preuves disponibles et toute affirmation faible ;
  7. approche visuelle et sources de ressources probables ;
  8. ambiance musicale et rythme ;
  9. fourchette de durée ;
  10. complexité de production et risques.

Notez le hook de 0 à 2 pour la clarté, la vérité, la pertinence pour le public et le bénéfice. Rejetez un hook qui manque de vérité même s'il semble engageant. Ne gonflez pas chaque option au même score parfait ; lorsque les scores sont à égalité, expliquez le véritable compromis et choisissez en fonction de l'adéquation au public, de la force des preuves et du bénéfice visuel. Recommandez une direction et expliquez ce compromis en une ou deux phrases.

Présenter le point de contrôle

Utilisez un tableau de comparaison non répétitif suivi d'une recommandation et d'une question compacte. Demandez à l'utilisateur de sélectionner une option, de combiner les options nommées ou de demander une nouvelle direction. Interrogez sur la durée, la tension et l'appel à l'action uniquement si ceux-ci restent conséquents et non résolus.

Ce premier passage se termine à directions_proposed. Arrêtez-vous après la demande de choix. Ne produisez pas de narration complète, n'appelez pas Kokoro, ne téléchargez pas de ressources, ne créez pas de code Remotion et ne rendez pas.

Lors de la persistance des artefacts, écrivez :

  • request.json et state.json avant le début de la recherche ;
  • research.md pour les humains ;
  • research.json pour les affirmations et la provenance ;
  • directions.json pour les choix ;
  • direction.json uniquement après que l'utilisateur a sélectionné, passant l'état à direction_selected.

Signalez quels faits restent incertains et quel choix est requis pour la Phase 2.

Individual skills in this repo

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

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

Skills associés