Communitygithub.com

nateherkai/hyperframes-student-kit

Deuxième agent de la pipeline de montage vidéo. Détecte et supprime les erreurs orales — bégaiements, mots répétés, faux départs et reprises (lignes réenregistrées) — d'un enregistrement en plan poitrine. À utiliser après la coupe des silences, lorsqu'on demande de couper les erreurs, supprimer les bégaiements/répétitions/reprises, nettoyer les cafouillages ou garder la meilleure prise. Fonctionne avec validation : il propose chaque coupe avec contexte et motif d'approbation, puis ne rend que les coupes approuvées via ffmpeg. Nécessite une transcription mot à mot.

Qu'est-ce que hyperframes-student-kit ?

Cet agent est la deuxième étape d'une pipeline de montage vidéo automatisée, conçue pour être exécutée après la première étape de coupe des silences. Il se concentre sur la détection et la suppression des erreurs de parole dans les enregistrements en plan poitrine : bégaiements (mots immédiatement répétés comme 'le le'), faux départs (phrase abandonnée et recommencée), et reprises (ligne réenregistrée dont on garde la meilleure prise). Comme il est impossible de distinguer mécaniquement une répétition emphatique ('jamais, jamais') d'un vrai bégaiement, l'agent est conçu pour être validé : il propose chaque coupe potentielle avec le texte supprimé, le texte conservé, le contexte environnant et une recommandation, puis attend que l'utilisateur approuve ou rejette chaque coupe. Seules les coupes approuvées sont appliquées via ffmpeg, produisant une vidéo et un nouveau fichier de transcription recalé, prêt à être transmis à l'agent suivant (graphismes animés). L'outil nécessite une transcription mot à mot au format JSON. Un outil de révision HTML est également fourni pour inspecter visuellement les coupes. Cette approche combine détection automatique et jugement humain pour un résultat propre sans sur-correction.

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

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 erreurs et répétitions (Agent de pipeline 2)

Deuxième étape du montage automatisé, à exécuter après cut-silences. Elle supprime ce qu'un monteur humain couperait lors d'un second passage : bégaiements (« le le », « j- j- »), mots immédiatement répétés, faux départs (phrase abandonnée et recommencée), et reprises (ligne réenregistrée — garder la prise propre, jeter la ratée).

Décider ce qui constitue une erreur relève du jugement, pas d'une formule — une répétition emphatique (« jamais, jamais ») et un dédoublement rhétorique (« le premier morceau est, est-ce que… ») ressemblent mécaniquement à un bégaiement. Par défaut, cet agent est donc soumis à validation : il présente des coupes candidates avec leur contexte complet ; l'agent (et l'utilisateur) décident ; seules les coupes approuvées sont rendues.

Quand l'utiliser

  • « coupe les erreurs », « supprime les bégaiements / répétitions », « nettoie les cafouillages », « garde la meilleure prise », « coupe les faux départs »
  • Comme deuxième étape du workflow de montage principal, sur la sortie de cut-silences.

Le flux en trois parties

1. Trouver les candidates (mécanique)

node .agents/skills/cut-mistakes/scripts/find-cut-candidates.mjs \
  <silence-transcript.json> --out-dir video-projects/<slug>/assets

L'entrée est normalement le <stem>.silence-transcript.json de l'Agent 1, de sorte que les coupes tombent sur la timeline déjà silencée. Écrit :

  • <stem>.cut-candidates.json — candidates structurées (type, confiance, plage cut proposée, texte removes/keeps, contexte, recommandation)
  • <stem>.cut-candidates.md — proposition lisible

Types de candidates : stutter (répétition immédiate d'un mot), retake (segment dupliqué/quasi-dupliqué via similarité de Jaccard), false_start (courte phrase abandonnée qui redémarre).

2. Validation (le verrou — OBLIGATOIRE)

Lisez chaque candidate dans son contexte et décidez de la garder ou de la couper. Le détecteur mécanique ne peut pas distinguer une répétition intentionnelle/d'une vraie erreur, donc ne faites pas aveuglément confiance à recommend — lisez removes + context. Faux positifs courants : répétition emphatique (« ce n'est jamais, jamais sans intervention »), copule puis question (« le morceau est, est-ce que… »), énumérations.

Présentez les candidates à l'utilisateur avec une recommandation par élément ; recueillez les approbations. Écrivez les coupes approuvées dans un fichier :

{ "cuts": [ { "start": 100.93, "end": 101.06, "reason": "faux départ J-" }, ... ] }

(start/end en secondes sur la timeline vidéo/transcription d'entrée. Vous pouvez élargir la plage d'une candidate — par exemple pour une reprise, couper du début de la prise ratée jusqu'au redémarrage propre.)

3. Appliquer les coupes approuvées

node .agents/skills/cut-mistakes/scripts/apply-cuts.mjs \
  <silence-transcript.json> --cuts approved-cuts.json \
  --video video-projects/<slug>/assets/edited-silenced.mp4 \
  --output video-projects/<slug>/assets/edited-clean.mp4 --apply

Écrit l'EDL, une transcription ré-échelonnée <stem>.mistakes-transcript.json (alimente l'agent graphismes animés + validate-beat-sync.mjs), un journal des décisions, et — avec --apply — la vidéo coupée (trim+concat ffmpeg, A/V synchronisé). Omettez --apply pour un essai à blanc.

Réviser le résultat

Utilisez l'outil de révision partagé pour inspecter les coupes et vérifier les limites :

node scripts/build-edl-review.mjs <stem>.mistakes-edl.json \
  --original video-projects/<slug>/assets/edited-silenced.mp4 \
  --edited   video-projects/<slug>/assets/edited-clean.mp4 \
  --output   video-projects/<slug>/assets/mistakes-review.html
npx serve . -p 8080 -n

Remarques

  • Un enregistrement très propre peut donner peu ou pas de coupes réelles — c'est un résultat valide ; ne coupez pas la parole naturelle pour atteindre un quota.
  • Les coupes entre deux mots parlés sont des jonctions dures. Elles sont généralement propres pour les bégaiements/faux départs ; pour un audio plus serré, un fondu de 20 à 30 ms peut être ajouté ultérieurement.
  • Transmettez le mistakes-transcript.json + la vidéo nettoyée à l'Agent 3 (graphismes animés / cartes hiérarchisées).

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

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