Communitygithub.com

nateherkai/coupures-silences-kit-étudiant

Agent 1 du pipeline de montage vidéo. Supprime les silences et les blancs d'un enregistrement tête parlante. À utiliser pour couper les silences, réduire les pauses, supprimer les blancs / trous, ou resserrer le rythme d'une vidéo brute à partir d'une transcription mot à mot. Produit une liste de montage (EDL), une transcription ré-ajustée pour les agents en aval, et optionnellement la vidéo coupée via ffmpeg. Ne coupe PAS les erreurs, les répétitions ou les faux départs — c'est le rôle de l'agent coupe-erreurs.

Qu'est-ce que coupures-silences-kit-étudiant ?

Cette compétence (Agent 1 du pipeline) automatise la première étape du montage vidéo : la suppression des silences dans un enregistrement tête parlante. Elle prend une transcription mot à mot (format ElevenLabs Scribe ou générique) et une vidéo brute, puis supprime uniquement les blancs : le vide avant le premier mot, après le dernier mot, et les pauses inter-mots plus longues qu'un seuil configurable (par défaut 0,55 s), réduites à une respiration naturelle. Elle ne touche pas aux mots du locuteur — les faux départs, répétitions et bégaiements sont traités par l'Agent 2 (coupe-erreurs). Utile pour les créateurs de contenu, monteurs vidéo et workflows automatisés avec des agents comme Claude Code ou Codex, elle produit une liste de montage (EDL), une transcription ré-ajustée sur la timeline éditée, et peut générer la vidéo finale via ffmpeg. Son fonctionnement est déterministe et basé sur la transcription, garantissant une sortie propre pour les étapes suivantes (validation du synchronisme des battements, etc.). Les options incluent le réglage du seuil de silence, des marges avant/après, et l'application directe du rendu.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/cut-silences

Demander à votre IA préférée

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

Documentation

Couper les silences (Agent 1 du pipeline)

Première étape du montage automatisé. Prend un enregistrement brut + sa transcription mot à mot et supprime uniquement les silences : le vide avant le premier mot et après le dernier mot, ainsi que les pauses inter-mots plus longues qu'un seuil (réduites à une respiration naturelle, jamais un trou absolu). Elle laisse les mots du locuteur intacts — les faux départs, reprises et bégaiements sont le travail de l'agent coupe-erreurs (Agent 2).

Cet agent est déterministe et piloté par la transcription, donc sa sortie (*.silence-transcript.json) s'intègre proprement dans les agents suivants et le validateur de synchronisme des battements.

Quand l'utiliser

  • "couper les silences", "réduire les pauses", "supprimer les blancs", "resserrer le rythme"
  • Comme première étape du workflow de montage principal, juste après la transcription.

Prérequis

Une transcription mot à mot au format JSON. Soit le format ElevenLabs Scribe ({ words: [{ text, start, end, type }], audio_duration_secs }) soit un format générique { words: [{ text, start, end }] }. Générez-en une avec le transcripteur de l'espace de travail :

node scripts/transcribe-elevenlabs.mjs chemin/vers/raw.mp4    # -> chemin/vers/raw.json

Utilisation

# 1) Planification uniquement — calcule la coupe, écrit l'EDL + la transcription ré-ajustée (aucune vidéo touchée)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcription.json> \
  --out-dir video-projects/<slug>/assets

# 2) Avec une vidéo — écrit également la commande ffmpeg (toujours pas de rendu)
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcription.json> \
  --video video-projects/<slug>/assets/raw.mp4 --out-dir video-projects/<slug>/assets

# 3) Rendre la vidéo coupée (ffmpeg local, ré-encodage, audio/vidéo synchronisés)
#    ajouter --apply pour exécuter ffmpeg
node .agents/skills/cut-silences/scripts/cut-silences.mjs <transcription.json> \
  --video video-projects/<slug>/assets/raw.mp4 --apply \
  --output video-projects/<slug>/assets/edited-silenced.mp4

Options

OptionDéfautSignification
--video <chemin>—Vidéo source ; active la commande / le rendu ffmpeg
--out-dir <répertoire>à côté de la transcriptionOù les sorties sont écrites
--output <chemin><vidéo-stem>.silenced.mp4Chemin de la vidéo coupée
--gap <s>0.55Pause minimale traitée comme silence coupable
--head-pad <s>0.22Silence conservé avant le premier mot
--tail-pad <s>0.34Silence conservé après le dernier mot
--applydésactivéExécute effectivement ffmpeg pour rendre la coupe

Comment ça décide (les règles de silence)

  • Les pauses inférieures à --gap (0,55 s) sont laissées intactes — rythme naturel de la parole.
  • Pour une pause coupée, une respiration naturelle est conservée, ajustée selon le contexte : 0.24 s pour les pauses longues (≥2 s), 0.20 s après un signe de ponctuation de fin de phrase (. ! ?), 0.14 s sinon. La respiration conservée est légèrement décalée vers la fin de la phrase précédente.
  • Les blancs de début/fin sont réduits à --head-pad / --tail-pad.
  • Les plages de suppression sont fusionnées ; les plages conservées sont le complément. La coupe est rendue avec un graphe de filtres trim/atrim + concat de ffmpeg (écrit dans un fichier *.silence-filter.txt et passé via -/filter_complex), donc la vidéo et l'audio restent synchronisés.

Sorties (écrites dans --out-dir)

FichierObjectif
<stem>.silence-edl.jsonPlages de conservation/suppression, durées, paramètres — la liste de montage
<stem>.silence-transcript.jsonMots ré-ajustés sur la timeline éditée (alimente l'Agent 2 + les battements)
<stem>.silence-decisions.mdRésumé lisible + les plus grandes pauses coupées
<stem>.silence-filter.txtLe graphe de filtres ffmpeg (uniquement avec --video)
<video-stem>.silenced.mp4La vidéo coupée (uniquement avec --apply)

Le résumé JSON envoyé sur stdout inclut removed, removedPct, les nombres de plages et les chemins de sortie — utile pour que le workflow principal journalise et enchaîne.

Notes de réglage

  • Par défaut pour YouTube tête parlante (--gap 0.55), environ 15 à 20 % d'une prise brute typique est supprimée comme pur silence. Réduisez --gap pour un montage plus percutant et rapide ; augmentez-le pour préserver plus de respiration naturelle.
  • Si une coupe semble trop agressive aux limites des phrases, augmentez la respiration de fin de phrase, ou augmentez --gap.

Passage à l'agent suivant

Passez <stem>.silence-transcript.json (et le silenced.mp4 s'il a été rendu) à l'agent coupe-erreurs. Comme les horodatages sont déjà sur la timeline éditée, le calage des battements en aval et scripts/validate-beat-sync.mjs fonctionnent sans ajustement supplémentaire.

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Skills associés