Communitygithub.com

100x-video-reverse

Transforme une ou plusieurs vidéos de référence locales en un pack d'analyse vérifiable, générable et consultable directement dans une conversation Agent, comprenant le plan de scènes, les trames clés, la bibliothèque d'actifs et un plan de génération segmenté.

Qu'est-ce que 100x-video-reverse ?

Ce skill permet de déconstruire une ou plusieurs vidéos de référence locales en un « pack d'analyse inversée » (reverse pack) structuré, prêt à être examiné par l'utilisateur et consommé par d'autres skills de génération en aval. Son objectif est l'analyse et la validation, pas la génération payante, le téléchargement ou la publication. Il prend en charge les agents comme Claude Code, Cursor et Codex avec des modes de sortie adaptés (`--format md` pour les clients texte, `--format fragment` pour Codex). Le flux de travail suit une séquence rigoureuse : préparation des preuves (empreintes, découpage proposé, trames denses, pistes audio), analyse sémantique (priorité aux capacités locales de l'agent, recours possible à `gemini-3.7-flash` si autorisé et vérifié), établissement d'identifiants stables pour les actifs (personnes, produits, décors, costumes, audio, texte) sans inventer d'informations non observables, puis génération d'un fichier `reverse.json` complet avec plans, trames clés, références d'actifs, prompts et plans d'exécution. Le pack est ensuite matérialisé, validé avec des vérifications strictes (erreurs irrécupérables bloquantes) et livré via un digest. Les retours utilisateur sont traités comme des « préférences/corrections » distinctes des observations originales, en créant une nouvelle révision sans écraser la précédente. Des garde-fous stricts empêchent l'upload non autorisé, les suppositions sur les marques/prices/effets flous, et la génération de contenu dans ce skill même.

Compatible avec✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/kezd088/100x-skill-tiktok/tree/main/skills/100x-video-reverse

Demander à votre IA préférée

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

Documentation

100X Video Reverse v2.3

Convertit une vidéo de référence en un pack d'analyse inversée standard que l'utilisateur peut examiner directement et que les skills de génération en aval peuvent consommer. Par défaut, seules l'analyse et la validation sont effectuées ; ni génération payante, ni téléchargement de la vidéo source, ni publication de contenu.

Avant de commencer

  1. Vérifier la lisibilité de la vidéo fournie par l'utilisateur et les limites d'autorisation. Si l'utilisateur n'a pas spécifié de répertoire de sortie, utiliser directement outputs/100x-video-reverse/<video-stem>-<timestamp>/ dans l'espace de travail courant, sans poser de questions supplémentaires pour le choix du répertoire ; toujours lire le fichier source en lecture seule et écrire dans un nouveau répertoire dédié.
  2. Toujours lire workflow.md, output-contract.md et native-output.md. Lire analysis-prompt.md uniquement lors de l'analyse du modèle. Lire failure-gates.md lorsque des textes commerciaux, un montage dense, un téléchargement externe ou une préparation pour la génération sont impliqués. Ne lire golden-baseline.md que pour évaluer, remplacer ou mettre à niveau ce skill. La livraison par défaut est générée de manière déterministe par scripts/digest.py à partir du pack machine ; l'agent ne réorganise pas manuellement les segments.
  3. Vérifier la disponibilité de ffmpeg, ffprobe, Python jsonschema et les permissions de lecture/écriture locales. Si jsonschema manque, le validateur doit s'arrêter immédiatement ; ne l'installer que dans un environnement isolé, pas globalement. Avant d'appeler un modèle externe, vérifier en temps réel la liste officielle des modèles et leurs limites d'entrée ; le modèle spécifié par l'utilisateur a la priorité. En cas d'impossibilité de vérification, arrêter les appels externes mais continuer le pack de preuves local.

Flux d'exécution

  1. Utiliser scripts/prepare_evidence.py pour établir l'empreinte du fichier source, ses spécifications, une proposition de découpage à double seuil, des trames denses et une piste audio indépendante. Les points de découpage automatiques ne sont que des signaux de diagnostic, pas de véritables limites de plans.
  2. Examiner simultanément la vidéo complète et le pack de preuves, en privilégiant les capacités de compréhension multimédia locales de l'agent actuel, sans exiger de l'utilisateur une API supplémentaire. Ce n'est que lorsque la tâche courante autorise explicitement une analyse sémantique externe qu'il est possible d'utiliser le modèle gemini-3.7-flash officiel de Google, comme dans le golden sample ; avant tout appel, vérifier l'ID réel et la capacité d'entrée vidéo depuis la liste officielle des modèles. Si le modèle n'est pas disponible, conserver l'erreur originale et arrêter la phase externe, sans passer silencieusement à un modèle plus ancien. Corriger la chronologie des plans selon analysis-prompt.md, en distinguant les faits observables, les inférences et les inconnues, sans utiliser d'intervalles fixes pour remplacer les coupes sémantiques.
  3. Établir des identifiants stables pour les actifs et des points d'ancrage de cohérence inter-plans, couvrant les personnes, les produits, les décors, les accessoires, les vêtements, l'audio et le texte. Les marques, prix, effets, répliques et textes à l'écran qui ne sont pas clairement visibles ou audibles ne doivent pas être inventés.
  4. Générer un fichier reverse.json complet : plans, quatre types d'images clés, références d'actifs, audio/sous-titres, prompts génériques, prompts adaptés au modèle, plan de segmentation, instructions de montage et must_not_change. Chaque segment doit également inclure un execution_plan : durée cible, statut de génération, modèle sélectionné, méthode de génération et素材 d'entrée ; sans vérification en temps réel des capacités du modèle, écrire explicitement needs_model_selection, ne pas faire semblant d'être exécutable.
  5. Utiliser scripts/materialize_reverse_media.py pour matérialiser les images de plans et les captures d'actifs dans des chemins relatifs au sein du pack, et générer materialization_manifest.json. Les médias existants ne sont réutilisés que si leur SHA-256 source, leur horodatage de demande et leur SHA-256 de fichier correspondent tous aux provenance ; sinon, arrêt immédiat, sans écrasement.
  6. Utiliser scripts/validate_reverse_package.py pour effectuer une pré-vérification des médias et du contrat. Les erreurs bloquantes doivent être corrigées avant de continuer ; les avertissements doivent être conservés et expliqués, non transformés en succès.
  7. Après une validation stricte réussie, exécuter scripts/digest.py, puis livrer exactement comme spécifié dans native-output.md. Codex utilise --format fragment --fragment-dir <répertoire de visualisation du thread> : le premier onglet affiche un lecteur 9:16 étroit à gauche + un panneau de素材 de segmentation à droite, chaque segment affiche toujours ensemble la première image / l'image clé / la dernière image ; les images peuvent être extraites en aperçu JPEG, pour l'original copier le chemin de l'image originale dans le pack. « Localisation des plans » conserve la liaison plan par plan ; cliquer sur une image triple ou un plan met en pause et localise la vidéo, affiche d'abord les instructions d'utilisation en chinois, puis le prompt de génération en anglais du segment correspondant. En écran étroit, la disposition devient verticale mais les trois images restent groupées. Les autres clients utilisent --format md par défaut ; s'il est impossible de déterminer les capacités du client, ne pas parier sur un protocole intégré.

Lorsque l'utilisateur donne des retours visuels, associer chaque retour à un plan, un actif ou un champ de prompt spécifique, et le marquer explicitement comme « préférence/correction utilisateur », sans le réécrire comme un fait observé dans la vidéo source. Créer un nouveau pack de révision, ne modifier que les champs et médias concernés, puis revalider complètement ; ne pas écraser la version précédente.

Commandes

python <skill-root>\scripts\prepare_evidence.py --video <source.mp4> --out <new-package-dir>
python <skill-root>\scripts\materialize_reverse_media.py --video <source.mp4> --package <new-package-dir>\reverse.json --source-manifest <new-package-dir>\source_manifest.json
python <skill-root>\scripts\validate_reverse_package.py --package <new-package-dir>\reverse.json --source-manifest <new-package-dir>\source_manifest.json --require-media --report <new-package-dir>\validation.json
python <skill-root>\scripts\digest.py --package <new-package-dir> --format md
# Pour Codex en ligne ; pour plusieurs packs, utiliser --out-root, qui génère automatiquement 1 aperçu global du lot + N détails indépendants
python <skill-root>\scripts\digest.py --out-root <batch-root> --format fragment --fragment-dir <thread-visualization-dir>

<new-package-dir> ne doit pas exister ou doit être vide. Ne pas utiliser --out pour pointer vers le répertoire de la vidéo source.

Limites infranchissables

  • Un pack d'analyse inversée validé indique seulement que la structure, les preuves et les références sont exécutables ; cela ne signifie pas que la similarité visuelle de la vidéo finale est satisfaisante.
  • Ne pas générer, réessayer de générer, effectuer de post-traitement ou noter dans ce skill. Ces tâches doivent être consommées par un skill indépendant via ce contrat de sortie.
  • La réponse native de l'agent n'est qu'une couche de présentation de reverse.json et des médias du pack, pas une seconde source de vérité métier ; toute révision modifie d'abord le pack machine, puis rafraîchit la réponse actuelle.
  • Cliquer sur un plan affiche le prompt du segment de génération auquel il appartient ; l'unité de génération du contrat machine est le segment, il ne faut pas prétendre qu'il existe des prompts indépendants plan par plan.
  • Les étiquettes opérationnelles, statuts, catégories d'actifs et méthodes de génération visibles par défaut sont en chinois ; les ID de modèle, ID de素材, preuves textuelles et prompts de génération en anglais conservent leur valeur d'origine. Si les champs lisibles par l'homme d'un pack historique sont en anglais, les signaler et conserver le texte original, sans que le digest ne falsifie une traduction.
  • Ne pas écrire de « tranches fixes de 10 secondes » comme vérité de plan en raison des limites actuelles du fournisseur. Prioriser les véritables plans et les limites narratives pour la segmentation ; l'avertissement de compatibilité aval de 10 secondes du validateur est uniquement configurable.
  • Sans autorisation explicite, ne pas télécharger la vidéo locale vers une URL publique, un stockage d'objets ou un service tiers.
  • Ne pas copier de code candidat dont la licence est peu claire ou l'usage contraire ; n'absorber que les méthodes et les échecs validés par le golden sample.

Critères d'achèvement

À la fin, doivent exister : source_manifest.json, evidence/evidence_manifest.json, les médias de preuve, reverse.json, materialization_manifest.json et validation.json ; la validation stricte des médias doit comporter zéro erreur bloquante. Le premier onglet d'un fragment Codex doit afficher un aperçu complet de la durée ; en bureau, utiliser une colonne de lecteur étroit + un panneau large de素材 de segmentation, chaque segment doit avoir exactement les trois emplacements (première image / image clé / dernière image) et rester groupé ; les素材 manquants affichent un emplacement d'erreur. Le glisser-déposer des trois images doit au moins produire un fichier JPEG utilisable ; l'original s'obtient en copiant le chemin de l'image dans le pack. Cliquer sur une image triple ou un plan permet de localiser et de consulter le prompt du segment correspondant. La couche opérationnelle par défaut utilise le chinois, les prompts en anglais se déploient sur demande ; les cinq autres blocs se déploient ensuite. Pour plusieurs packs, donner d'abord un aperçu léger du lot, puis pour chaque numéro un détail indépendant ; les entrées en échec ne doivent pas disparaître. Le chemin du pack machine doit toujours être donné dans le corps du texte. --legacy-unverified-media est autorisé uniquement pour l'audit des packs historiques, interdit pour les nouvelles livraisons.

Limitations connues

  • Dans un fragment, la « vidéo originale » est une copie d'affichage à débit réduit en H.264/AAC pour la durée totale dans le budget ; ce n'est pas une seconde source ; le chemin d'origine et le SHA-256 restent définis par source_manifest.json. Les fragments uniques sont limités à 1 Mo ; si la vidéo ne tient pas, la rétrograder explicitement en images, sans la tronquer.
  • Le glisser-déposer depuis un fragment produit des images JPEG d'aperçu dérivées dans le budget, pas les trames originales du pack ; le glisser-déposer fournit également un objet File du navigateur, un DownloadURL Chromium, une URI de données et le chemin de l'image originale. L'application cible détermine si elle accepte le format de glisser-déposer ; pour obtenir l'image sans perte, utiliser « Copier le chemin de l'image originale ».
  • Le chemin Artifact de Claude Code n'a pas encore été réellement validé par l'hôte ; en cas d'impossibilité de confirmation du rendu, revenir à --format md.

Individual skills in this repo

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

Skills associés