Communitygithub.com

Malik-rgb43/editing-workflow

Convertit une vidéo (fichier, lien YouTube/TikTok/Instagram ou dossier de clips) en mesures (coupes, rythme, données par image), planches d'images clés, transcription hébraïque et analyse audio (SFX, BPM, tonalité, beats, identification de chanson).

Qu'est-ce que editing-workflow ?

Cette compétence transforme une vidéo brute en un ensemble structuré de données lisible par un modèle d'IA : mesures numériques par image, planches de contacts horodatées, transcription (avec support hébreu forcé), et une analyse audio complète (BPM, tonalité, beats, identification de chanson, effets sonores). Elle s'appuie sur des outils locaux gratuits et privés, sans aucune API distante de compréhension vidéo ni téléversement de contenu. Le processus suit une procédure rigoureuse avec plusieurs étapes de validation : pré-vérification de l'environnement, analyse en arrière-plan, validation des fichiers produits, revue manuelle des planches et images audio, correction des comptes automatiques de coupes, et génération d'un rapport de synthèse. Le système impose des garde-fous stricts (intégrité des entrées, couverture déclarée, régression des détecteurs, respect de la vie privée) et ne jamais éditer, rendre ou appliquer un style. Il est conçu pour les développeurs qui ont besoin d'une analyse vidéo détaillée, reproductible et vérifiable, notamment pour des publicités, des vidéos promotionnelles ou des contenus en hébreu, sur des plateformes comme Claude Code, Cursor ou tout outil compatible Python.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/video-analysis

Demander à votre IA préférée

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

Documentation

Analyse vidéo

Convertit une vidéo en ce qu'un modèle peut lire : une mesure numérique de chaque image, des planches de contacts horodatées, une transcription, une chronologie sonore et des images de spectrogramme, puis une analyse écrite à partir de ces données. Il s'agit d'une procédure utilisant l'outil d'analyse, pas de l'outil lui-même (le script privé du propriétaire n'est pas distribué ; le portage étudiant suit TOOLS_SPEC). Il n'édite jamais, ne rend jamais et n'applique jamais un style.

Règles qui prévalent sur le reste de ce fichier

  1. Les entrées sont en lecture seule. Hachage avant et après (input.sha256 = sha256_after) ; les sorties vont uniquement dans analysis/<video>/. Téléchargez uniquement l'URL donnée par l'utilisateur, en nommant la source et le fichier ; c'est une copie de référence, jamais redistribuée ; un filigrane de la plateforme, une carte de fin et un jingle sont exclus des statistiques et listés.
  2. La couverture est indiquée en premier. Chaque rapport commence par un bloc de couverture : complète ou échantillonnée, images décodées sur attendues, ce qui a été exclu, ce qui n'a PAS été exécuté. Un échantillon n'est jamais présenté comme une couverture complète. Une exécution échantillonnée ne peut pas citer les comptes de coupes ou le rythme comme des faits mesurés.
  3. Exécutez l'outil ; n'échantillonnez jamais manuellement avec ffmpeg. Si l'outil est manquant, indiquez bloqué : outil_manquant et demandez ; un repli manuel n'est autorisé que comme un aperçu explicitement étiqueté échantillonne sans comptes.
  4. Lisez avant d'écrire : visualisez CHAQUE planche et CHAQUE image audio ; zoomez 3 à 6 fois ; décidez chaque point de montage check à partir des images ; corrigez les comptes erronés et signalez-le.
  5. Local, gratuit, privé. Pas d'API payante de compréhension vidéo, pas de téléversement de la vidéo, de ses images ou de son audio, pas d'identification de chanson à distance sur du contenu privé, sans un devis daté et une approbation préalable (paid-generation-gate). Le discours hébreu est forcé à he ; ne vous fiez jamais à une seule passe ASR pour les noms, les marques et les nombres.
  6. Une correspondance de chanson n'est pas une licence. Rapportez "identifié comme X, licence de synchronisation non établie" ou "non identifié" ; n'inventez jamais un titre. Les étiquettes de type AudioSet sont des suppositions ("probablement un whoosh") ; le tempo et la tonalité sont des estimations avec vérification moitié/double tempo.
  7. Un seul travail lourd à la fois sous render_lock ; tout ce qui dépasse environ 2 minutes s'exécute en arrière-plan avec un journal et une ETA ; pas de promesse de temps d'exécution (lot du propriétaire : 9-23 min par vidéo sous charge, dépendant de la machine). Les compétences sont une procédure, pas une permission : les restrictions de l'utilisateur et du projet prévalent sur ce fichier.

Interface d'outil attendue par cette compétence (TOOLS_SPEC video-analysis ; vérifiez avec --help)

python tools/analyze.py <video|URL|dossier> --out analysis/<video> [--detail rapide|standard|complet]
       [--asr auto|toujours|jamais] [--no-song-id] [--no-audio-ai] [--check]
python tools/frames.py <video> --at <t> --pad 0.25 --out analysis/<video>     # chaque image d'une courte fenêtre

Contrat de sortie (references/output-contract.md) : analysis/<video>/{measurements.json, frames.csv, sheets/ (index.json + images), transcript.json, audio.json} + breakdown.md.

Procédure

#FaireArtefact
0Demander uniquement ce qui change l'exécution : analyse complète ou une question (coupes / transcription / chanson) ? Contenu confidentiel (privé) ? Quelle langue pour l'analyse ? Un dossier : listez-le d'abord ; ne jamais écraser une analyse antérieureligne de portée
1Pré-vol (analyze --check / doctor) : enregistrer OS, ffmpeg, route ASR détectée (CPU / Vulkan / CUDA / MLX ; aucune si non détectée), le drapeau d'environnement Vulkan ; pas de route = bloqué pour la transcription uniquementbloc environnement
2Exécuter en arrière-plan sous le verrou. --detail : rapide pour corpus/longue discussion, standard par défaut, complet pour graphiques animés, montages très rapides ou une référence à transférer (references/thresholds.md). Plusieurs vidéos : un lot, puis un agent par vidéo (son dossier uniquement, breakdown.md comme sortie, échéance, réponse <= 10 lignes)dossiers d'analyse
3python scripts/validate_analysis.py analysis/<video> --stage producedRÉUSSI ou les composants défaillants
4Lire : toutes les planches, toutes les images audio ; zoomer uniquement sur les écrans distincts ; résoudre les points check ; corriger le compte (pacing.override + review.corrections) ; vérifier le tempo moitié/doublebloc review
5python scripts/validate_analysis.py analysis/<video> --video <source> ; sortie 0 requise pour présenter les chiffres comme des faitsrapport de validation
6Écrire breakdown.md dans la langue de l'utilisateur selon references/reading-and-breakdown.md (couverture d'abord, 7 sections, incertitudes en dernier)breakdown.md
7Rapporter : le chemin du fichier, 5-10 lignes, les corrections, ce qui n'a pas pu être établi ; proposer la compétence suivante (reference-style-transfer, une compétence de type) au lieu de le fairemessage

Barrières

Les états sont réussi | échoué | bloqué | n/a avec une raison. Un délai d'attente, un échantillon vide ou une entrée manquante est bloqué, jamais réussi. Un appel d'outil réussi est une preuve d'exécution ; les planches visualisées sont une preuve d'apparence.

BarrièrePrédicatPreuveSi fauxPropriétaireRe-vérification quand
G1 profil machineRoute ASR détectée et enregistrée ; la route Vulkan enregistre GGML_VK_DISABLE_COOPMAT (le pilote AMD du propriétaire a besoin de =1 ; autres pilotes non testés)measurements.environment de doctor/--checkbasculer vers la route CPU et le dire ; ne jamais supposer un GPUcette compétence + doctornouvelle machine, pilote ou modèle
G2 contrat valideles cinq composants passent ou sont n/a avec une raisonvalidate_analysis.py sortie 0 (--video fourni)corriger ou ré-exécuter le composant ; signaler INSUFFISANT avec la pièce manquantevalidate_analysis.pytoute ré-exécution ou modification manuelle
G3 déclaration de couverturele rapport s'ouvre avec le mode, images décodées/attendues, exclusions, liste non exécutée, reclamations_non_autoriseespremier bloc de breakdown.mdl'ajouter ; rétrograder les affirmations à "échantillonné"cette compétencechaque rapport
G4 régression du détecteur de coupestout changement d'un seuil de détecteur maintient F1 >= la base de référence de l'ensemble étiqueté (le propriétaire historique 0.89 = P 0.87 / R 0.91 sur 20 publicités vérifiées à la main, 339 points de montage, privé, non reproduit ; angle mort connu : typographie cinétique et pièces à caméra continue)cut_regression.py --pair ... --min-f1 0.89 sortie 0 avec >= 100 points de véritéannuler le changement de seuilcut_regression.pytout changement de détecteur ; jamais à l'œil
G5 entrées intactesle hachage source est égal avant et aprèsvalidate_analysis.py --videorestaurer le fichier depuis l'original, ré-exécutervalidate_analysis.pychaque exécution
G6 lire avant d'écrirechaque planche d'image clé/vue d'ensemble et image audio visualisée ; chaque point check résolu ; comptes vérifiés sur les imagesbloc review complet (étape revue)revenir en arrière et les visualisercette compétencechaque analyse
G7 vie privée et droitsentrée privée : pas d'identification de chanson à distance, pas d'ASR cloud, pas de téléversement d'image ; correspondance = pas de licencesong_id.status, asr.routesupprimer le journal d'extrait, ré-exécuter localementcette compétencechaque exécution

Chiffres et limites à citer avec leur portée

  • Détecteur de coupes : réglage du propriétaire uniquement (G4) ; le comptage automatique des coupes était erroné dans environ 60 % des vidéos promotionnelles jusqu'à vérification sur les images ; un exemple de typographie cinétique indiquait 108 coupes/min automatiquement contre 42 à partir des planches.
  • ASR (machine du propriétaire, E08, une passe, discours lu) : Vulkan 5.82 audio-s par mur-s, CPU CT2 int8 0.84, WER 17.7-19.4 % : references/volatile-facts.md (daté ; expire le 31/12/2026).
  • L'analyse sonore ne s'exécute que pour de vrai : beats/BPM/tonalité nécessitent >= 3 s de musique ; voix chantées nécessitent la passe de paroles sans VAD (segments confiants uniquement, étiquetés "PAROLES CHANTÉES").

Références (charger quand)

  • references/output-contract.md - écrire, porter ou déboguer un fichier de sortie ; lire un rapport de validation.
  • references/thresholds.md - régler ou porter le détecteur, choisir --detail, expliquer un compte erroné.
  • references/reading-and-breakdown.md - avant de lire les planches et avant d'écrire l'analyse.
  • references/volatile-facts.md - avant de citer toute vitesse, WER, prix, licence ou fait d'outil (module daté).
  • agent-content/references/asr-routes.md (routes ASR canoniques, détenues ailleurs) et hebrew-captions-asr (transcriptions de qualité sous-titres) ; reference-style-transfer consomme les dossiers de cette compétence.
  • Scripts : scripts/validate_analysis.py (vérification de contrat, --self-check), scripts/cut_regression.py (barrière F1, --self-check) ; les deux échouent fermés (sortie 0 / 1 / 2).

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Design, build and review a motion-graphics piece in HyperFrames/GSAP: product or app launch, feature announcement, kinetic typography, logo reveal, UI explainer, animated screenshots. Triggers: מושן גרפיקס, אנימציה, השקה, טיפוגרפיה קינטית, לוגו אנימציה, "like a Higgsfield / Linear launch". Not for a speaker-to-camera reel (edit-talking-head), AI-generated shots (edit-ai-generated), caption-only work (hebrew-captions-asr) or ad compliance (edit-ad-promo).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

Skills associés