Communitygithub.com

upload-preflight

Utilisez lorsque l'utilisateur a rendu ou exporté une vidéo verticale et souhaite savoir si TikTok, YouTube Shorts, Instagram Reels ou Facebook Reels l'accepteront, ou pourquoi un téléchargement ou une publication programmée a échoué. Exécute un vérificateur publié avec ffprobe et donne la correction FFmpeg pour chaque échec.

Qu'est-ce que upload-preflight ?

Ce skill agit comme un pré-contrôle de conformité pour les vidéos verticales destinées aux plateformes sociales (TikTok, YouTube Shorts, Instagram Reels, Facebook Reels). Il utilise un outil open source (shortform-preflight) qui lit la vidéo avec ffprobe et la compare aux spécifications publiées par chaque application. Pour chaque échec, il génère une commande FFmpeg de correction. Le skill distingue les règles de téléchargement standard (upload), les règles de l'API de publication (plus strictes pour Facebook et Instagram), et les profils spécifiques comme le Direct Post de TikTok. Il évite les erreurs courantes : ne pas ré-encoder si un remux suffit, ne pas modifier les dimensions sans demande, et ne pas traiter les avertissements comme des refus. Fonctionne avec npx et nécessite Node.js 18+, ffprobe et un accès réseau.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/viewgum/skills/tree/HEAD/skills/upload-preflight

Demander à votre IA préférée

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

Documentation

Pré-contrôle d'upload

Un rendu qui semble correct peut quand même être refusé ou retraité : mauvais format d'images par seconde pour une API, codec audio rejeté par un outil de publication, fichier trop volumineux, clip plus long que ce que l'application accepte. Ce skill exécute https://github.com/viewgum/shortform-preflight sur le fichier, qui le lit avec ffprobe et le compare aux chiffres publiés par chaque application, puis transforme chaque échec en une commande FFmpeg.

Pas pour : l'emplacement du texte dans l'image (utilisez short-form-specs), ni ce que dit la vidéo.

Workflow

  1. Clarifier le périmètre uniquement si nécessaire. Par défaut : les quatre applications et les règles de téléchargement dans chaque application (--route app). Pour le téléchargement web de TikTok, utilisez --route web. Si l'utilisateur publie via un planificateur ou son propre code, utilisez les règles de l'API de publication (--api), qui sont plus strictes pour Facebook Reels et Instagram. Pour TikTok Direct Post, transmettez la limite du compte (max_video_post_duration_sec depuis les informations créateur TikTok) comme --tiktok-endpoint direct --tiktok-max-seconds <n> ; sans cela, indiquez que la durée n'est pas vérifiée.
  2. Vérifier les outils : ffprobe -version (FFmpeg), node -v (18 ou plus récent) et npx --version. Le premier téléchargement du vérificateur depuis GitHub nécessite également un accès réseau. Si quelque chose manque, indiquez quoi, comment l'installer, et arrêtez.
  3. L'exécuter, en JSON pour pouvoir lire chaque ligne : npx -y github:viewgum/shortform-preflight <fichier> --json (ajoutez --api, ou --platform tiktok,youtube-shorts, selon les besoins). Code de sortie 0 signifie qu'aucune vérification n'a échoué ; 1 signifie qu'une vérification a échoué ou qu'une valeur requise n'a pas pu être lue (l'application apparaît comme incomplète ; indiquez quelle mesure manque) ; 2 signifie une entrée incorrecte.
  4. Pour chaque échec et chaque avertissement que l'utilisateur risque de rencontrer, donnez la cause en une ligne, la source citée par la ligne, et une correction. Corrections courantes (ajustez les chemins et conservez le reste du fichier tel quel) :
    • Fréquence d'images hors plage : ffmpeg -i in.mp4 -r 30 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a copy -movflags +faststart -use_editlist 0 out.mp4
    • Codec, chroma ou profil refusé : ffmpeg -i in.mp4 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -movflags +faststart -use_editlist 0 out.mp4
    • Atome moov à la fin, ou edit list (l'API Instagram refuse les deux) : ffmpeg -i in.mp4 -c copy -movflags +faststart -use_editlist 0 out.mp4
    • Fréquence d'échantillonnage audio, canaux ou débit binaire (l'API Facebook Reels liste 48 kHz stéréo, 128 kbps ou plus ; un encodeur réglé exactement à 128k moyenne souvent un peu en dessous) : ffmpeg -i in.mp4 -c:v copy -c:a aac -b:a 192k -ar 48000 -ac 2 -movflags +faststart -use_editlist 0 out.mp4
    • Trop long : coupez-le, ffmpeg -i in.mp4 -t 89.9 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -movflags +faststart -use_editlist 0 out.mp4 (réglez -t un peu en dessous de la limite : la coupe peut dépasser d'une image).
    • Plusieurs lignes à la fois : combinez les options en un seul ré-encodage plutôt que de chaîner des passes, comme dans l'exemple d'exécution.
    • Chaque ré-encodage : ajoutez -g 90 à 30 ips (-g 72 à 24) pour que les images clés arrivent toutes les 3 secondes ; l'API Facebook demande des groupes d'images fermés de 2 à 5 secondes, ce que le vérificateur ne peut pas tester. Vérifiez avec ffprobe -v error -select_streams v -skip_frame nokey -show_entries frame=pts_time -of csv=p=0 out.mp4.
    • Trop volumineux : abaissez le réglage de qualité (un -crf plus élevé) plutôt que la résolution.
    • Pas en 9:16 : padding ou recadrage à 1080 x 1920 uniquement si l'utilisateur le souhaite ; indiquez ce qui sera perdu.
  5. Après une correction, exécutez à nouveau le vérificateur sur le nouveau fichier et montrez que la ligne passe maintenant.

Format de sortie

**Fichier :** demo.mp4 · 1080 x 1920 · 95 s · 23.976 ips · H.264 · AAC
**Règles :** API de publication

| Application | Résultat | Lignes en échec ou avertissement |
|---|---|---|
| Facebook Reels | échec | durée 95 s (l'API accepte 3 à 90 s) ; fréquence d'images 23.976 (nécessite 24 à 60) ; 44,1 kHz et mono (48 kHz stéréo listé, avertissement) |
| Instagram Reels | échec | edit list présente (aucune autorisée) ; atome moov après les médias (doit être au début) |

### Correction
Un seul ré-encodage pour toutes les lignes : `ffmpeg -i demo.mp4 -t 89.9 -r 30 -c:v libx264 -crf 18 -pix_fmt yuv420p -c:a aac -b:a 192k -ar 48000 -ac 2 -g 90 -movflags +faststart -use_editlist 0 fixed.mp4`
(sources : Meta for Developers, Reels Publishing API et IG User Media)

**Après la correction :** aucun échec.
  • Citez les lignes du vérificateur lui-même ; ne récitez pas les limites de mémoire.
  • Indiquez quelles règles ont été utilisées : téléchargement application, téléchargement web ou API de publication.
  • Les lignes d'information (débits binaires recommandés, niveau sonore mesuré) ne sont pas des échecs ; mentionnez-les uniquement si l'utilisateur le demande.

Pièges courants

  • Ne ré-encodez pas lorsqu'un remux suffit. -c copy avec +faststart conserve la qualité.
  • Ne modifiez pas la résolution ou le rapport hauteur/largeur sauf demande de l'utilisateur ; demandez d'abord, car le recadrage perd de l'image.
  • Ne traitez pas un avertissement comme un refus. Dites ce que l'application peut faire (retraiter, rejeter via l'API) uniquement comme la source l'indique.
  • N'exécutez pas FFmpeg sur le fichier original. Écrivez toujours un nouveau fichier.
  • Ne devinez pas une limite que le vérificateur signale comme non publiée. Dites que l'application ne la publie pas.

Individual skills in this repo

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

Skills associés