Communitygithub.com

avenoxai/avenoxskills

Avenox Studio — pipeline de production vidéo local-first pour YouTube (ROUTER, à lire en premier). À utiliser pour toute demande de montage, découpage, production, assemblage, sous-titrage, composition musicale ou rendu d'une vidéo longue, ou pour créer des graphismes animés. S'appuie sur des outils open-source (auto-editor, mlx-whisper, MLT/melt, ffmpeg) et HyperFrames pour les graphismes animés. Déclencheurs : « monte cette vidéo », « coupe l'enregistrement », « fais des graphismes », « extrais les sous-titres », « rends le final », un nom de projet, ou toute mention du pipeline vidéo. L'humain est le réalisateur/gardien de la qualité ; l'agent est l'opérateur.

Qu'est-ce que avenoxskills ?

Cette compétence décrit Avenox Studio, un pipeline de production vidéo complet fonctionnant entièrement sur votre machine locale, conçu pour les créateurs YouTube produisant des vidéos longues. L'agent agit comme un opérateur technique tandis que l'humain reste le réalisateur et approuve la qualité finale. Elle prend en charge toutes les étapes : découpage automatique des silences, transcription locale avec mlx-whisper, création de graphismes animés via HyperFrames, assemblage d'un montage à partir d'un plan edit.json, sous-titrage, composition musicale, et rendu final. Basée sur des outils open-source (auto-editor, MLT/melt, ffmpeg), elle fonctionne principalement sur macOS avec Apple Silicon, mais peut être adaptée à Linux. Le pipeline impose une discipline stricte : les médias lourds ne doivent jamais être placés dans un dossier synchronisé dans le cloud, et aucun rendu final ne doit être livré sans validation humaine préalable.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/avenoxai/avenoxskills/tree/HEAD/skills/avenox-video

Demander à votre IA préférée

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

Documentation

Avenox Studio — routeur opérateur

Guide rapide de l'opérateur pour un pipeline vidéo local-first, piloté par un agent. Tout s'exécute sur votre machine : pas d'éditeur cloud, pas de téléversement pour le rendu.

L'humain dirige et approuve la qualité ; l'agent exécute le pipeline.

Configuration

export STUDIO_JOBS="$HOME/video/projects"   # les médias lourds vivent ici
export STUDIO_ROOT="/chemin/vers/ce/depot"  # scripts, templates, charte graphique

Prérequis : macOS (encodage matériel via h264_videotoolbox ; Apple Silicon pour mlx-whisper), ffmpeg, python3, melt/MLT, Node (pour HyperFrames). La plupart fonctionne sous Linux avec libx264 et une version CUDA de whisper adaptée.

Principes de fonctionnement

  1. Discipline des médias. Les médias lourds ne doivent JAMAIS se trouver dans un dossier synchronisé dans le cloud — la synchronisation saturerait sur des fichiers intermédiaires de plusieurs Go et pourrait corrompre les écritures en cours. Les projets vivent dans $STUDIO_JOBS/<job>// (raw/ cut/ graphics/ audio/ outputs/). Votre système de notes ne contient que le cerveau : ce système, la charte graphique, les plans edit.json.
  2. Boucle de validation. Produisez un aperçu (images des graphismes + un rendu rapide) → envoyez pour retours → seulement ensuite le rendu final. Ne livrez jamais un final sans validation. C'est la règle la plus importante ; un agent qui rend des finals non revus fera perdre des heures sur un montage rejeté.
  3. La charte graphique est une contrainte ferme, pas une suggestion. Lisez brand/frame.md avant de créer un graphisme. Définissez-la une fois et verrouillez-la. (L'implémentation de référence est délibérément anti-« AI slop » : éditorial premium, papier chaud + encre + un seul accent, pas de néon/gradient/glassmorphism/3D-brillant.)
  4. Format : YouTube 16:9 1080p60. Préréglage dans brand/presets/youtube-16x9.json.
  5. La finalisation est hybride. Générez automatiquement le brouillon ; le même fichier .mlt s'ouvre dans Kdenlive ou Shotcut pour une finition manuelle. N'essayez pas d'automatiser le goût.
  6. La transcription par défaut est LOCALE avec mlx-whisper et whisper-large-v3-turbo — rapide, gratuit et performant sur l'audio non-anglais. Notez que la plupart des proxies de routage LLM n'exposent pas de endpoint whisper ; si vous passez par le cloud, utilisez une API vocale dédiée.

Scripts (scripts/)

ScriptAction
`autocut.sh IN.mp4 [balancedaggressive
transcribe.py IN.mp4 PREFIX→ transcript/PREFIX_timed.json + _narration.txt
mltgen.py edit.json out.mlt --base <job-dir>plan de montage → projet MLT (Kdenlive/Shotcut/melt)
`vrender.sh project.mlt out.mp4 [fastquality]`
grabshot.shcapture d'écran du presse-papiers → disque
slides2png.shdiapositives statiques héritées — préférez HyperFrames
remove-silence.pypassage silences autonome

Les 7 étapes

  1. Réception — copie brute → $STUDIO_JOBS/<job>/raw/. Confirmez le brief et les segments qui comptent vraiment.
  2. Montage brut — autocut.sh raw.mov balanced → cut/screen_cut.mp4 ; transcribe.py pour le script. Recette complète → compétence avenox-roughcut.
  3. Graphismes — HyperFrames. Passez par la compétence hyperframes → généralement motion-graphics (courtes séquences), faceless-explainer (concepts développés) ou general-video. Lisez brand/frame.md d'abord ; rendez des MP4 animés dans graphics/. Recette complète → compétence avenox-graphics.
  4. Assemblage — écrivez edit.json (modèle dans templates/edit.json) en mélangeant cut/*.mp4 + graphics/*.mp4 + musique → mltgen.py edit.json project.mlt --base <job-dir>.
  5. Sous-titres — transcribe.py → .srt ; appliquez brand/caption-corrections.json (copiez-le depuis caption-corrections.example.json — un dictionnaire de recherche/remplacement pour les termes que votre ASR déforme systématiquement). Livrez en tant que CC YouTube, pas incrustés.
  6. Musique — tapis sonore sous tout, sidechain-duck sous la voix, ciblez ~-14 LUFS. Suivez les attributions dans CREDITS.md.
  7. Export — vrender.sh project.mlt draft.mp4 fast → validation du réalisateur → vrender.sh … final.mp4 quality → nettoyez les fichiers temporaires.

Niveau de qualité des graphismes

Les clips HyperFrames doivent respecter brand/frame.md. Préférez un mouvement typographique, sobre et pesant. Si un plan n'a pas besoin de mouvement, une image statique propre suffit — n'animez pas pour le plaisir d'animer.

Références

  • Montage brut : avenox-roughcut · Graphismes : avenox-graphics
  • Compétences HyperFrames : hyperframes (routeur), hyperframes-cli, hyperframes-animation, hyperframes-creative, motion-graphics, faceless-explainer, general-video
  • Charte graphique : brand/frame.md (à remplir depuis brand/frame.template.md)

Skills associés