Communitygithub.com

riffkit/skills

Transformez un TikTok gagnant en votre propre vidéo : même formule émotionnelle, votre produit, nouveaux plans. Collez le lien (ou téléchargez la vidéo), choisissez éventuellement un personnage, un produit et une langue, et le backend reconstruit ce qui a retenu l'attention (accroche, structure des temps forts, timing des dialogues) autour de votre contenu. Vous riffez la formule, pas la vidéo. Déclencheurs : 'riff cette vidéo', 'riff ce TikTok', 'transforme ce TikTok en mien', 'refais cette vidéo virale avec mon produit', 'recrée cette vidéo pour ma marque'.

Qu'est-ce que skills ?

Ce skill transforme une vidéo source gagnante (TikTok, lien, vidéo téléchargée) en une nouvelle vidéo qui reproduit la même formule émotionnelle, mais avec votre propre contenu : votre personnage, votre produit, votre histoire. Il repose sur trois modes : **adapt** (par défaut : analyse la formule émotionnelle de la source et la régénère avec votre récit), **swap** (garde les plans, les coupes et le timing de la source, mais remplace ce qui s'y trouve : personnage, produit, décor), et **creation** (crée une vidéo publicitaire originale à partir d'une direction créative écrite, sans vidéo source). Le skill est conçu pour les agents IA (Claude Code, Cursor, Codex, etc.) et propose une interface simplifiée : une seule page, un seul appel API (`POST /api/riffs`), avec des valeurs par défaut intelligentes pour la plupart des paramètres. La valeur ajoutée de l'agent réside dans la rédaction du `content_anchor`, c'est-à-dire la direction créative stratégique qui fusionne la formule de la source, le produit et le personnage en une instruction concrète. Le workflow complet inclut la sélection de la source, la configuration des options (personnage, produit, langue, content_anchor), une confirmation avant soumission (étape obligatoire), puis le suivi de la progression et la livraison de la vidéo finale avec légende et hashtags. Le skill gère également l'authentification, la facturation (avec gestion des erreurs HTTP 402), et les limites de création. Il est strictement interdit à l'agent de soumettre une tâche sans consentement explicite de l'utilisateur.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/riffkit/skills/tree/HEAD/riff-viral-tiktok

Demander à votre IA préférée

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

Documentation

Compétence Riffkit

Position de base : vous riffez la formule, pas la vidéo. Donnez une source gagnante ; le backend analyse la formule émotionnelle qui a capté l'attention et migre cette formule vers votre propre contenu. Les images peuvent être complètement différentes tant que le spectateur suit le même chemin psychologique.

Ou gardez les images : mode Swap (mode=swap). Lorsque l'utilisateur souhaite les plans exacts de l'original plutôt que sa formule (« mets-moi dans cette vidéo », « même vidéo, mon personnage »), un swap refilme la source fenêtre par fenêtre sur sa propre horloge : caméra, coupes, cadrage, action et timing restent ; ce qui change, c'est ce que l'utilisateur nomme : un personnage numérique à la place de la personne (pas de personnage = la personne d'origine reste), un produit, et content_anchor pour tout le reste (décor, tenue, formulation d'une réplique). Un swap doit modifier au moins une chose. Adapt (par défaut) garde la formule et change l'histoire ; Swap garde les plans et change ce qu'ils contiennent.

Un écran, une action : source (obligatoire) → paramètres optionnels → soumettre. Le produit réel est une seule page et un seul appel (POST /api/riffs). Chaque paramètre autre que la source a une valeur par défaut judicieuse — le personnage par défaut est Auto (pas d'humain numérique ; l'IA génère la personne à l'écran) et le produit par défaut est aucun. Lorsque l'utilisateur ne s'en soucie pas, l'agent applique les valeurs par défaut silencieusement au lieu de le traîner dans un assistant multi-étapes.

La contribution la plus stratégique de l'agent est content_anchor (la direction créative) — le seul degré de liberté stratégique : sur lequel des N arguments de vente du produit se concentrer, quelle surface remplir dans le mécanisme émotionnel du modèle. Il s'agit d'une collaboration optionnelle, pas un blocage obligatoire. Voir ## Cadre de rédaction du content_anchor ci-dessous.

Périmètre de la compétence

Cette compétence réalise des vidéos IA courtes dans exactement trois modes : les riffs adapt (par défaut : analyser la formule émotionnelle d'une vidéo source et la régénérer comme votre propre histoire), les riffs swap (POST /api/riffs avec mode=swap : conserver les plans, coupes et timing de la source, et y placer votre personnage, produit ou décor) et les vidéos de création (créer une vidéo publicitaire originale à partir d'une direction créative écrite — sans vidéo source ; POST /api/creation/batch). C'est toute la surface du produit. Si un utilisateur demande quelque chose en dehors de cela — un format de contenu différent, ou une fonctionnalité que ce produit n'a pas — dites clairement que ce produit ne fait que des vidéos de riff (adapt / swap) et de création ; n'appelez pas d'API non liées et ne l'orientez pas ailleurs.

Aucune fonctionnalité staff/admin n'est exposée. Cette compétence couvre uniquement les points de terminaison qu'un utilisateur normal authentifié peut appeler. Construire des modèles de plateforme en analysant de nouvelles sources, publier/dépublier des modèles de plateforme, la recherche de tâches inter-scopes, l'attribution/révocation manuelle de crédits — tout est réservé au staff. Ce document ne les mentionne jamais et l'agent ne les appelle jamais.

Langue

La sortie suit la langue d'entrée de l'utilisateur : répondez en anglais à l'anglais, en chinois simplifié au chinois ; pour une entrée mixte, suivez la langue dominante du message actuel. Le raisonnement interne de l'agent est exempté.

Gardez toujours textuellement (ne traduisez pas) : les ID de champs, les chemins d'API, template_type (uniquement pipeline), les statuts d'état (queued/running/completed/failed/dead/cancelled), les valeurs product_visibility (on_camera/off_camera/no_product), les noms de paramètres, le jeton vee_session.


Aperçu en une minute (TL;DR)

[Flux]
  0. Mode : adapt (par défaut : gardez la formule, nouvelle histoire) / swap (mode=swap : gardez les plans, échangez qui est dedans)
            ↓
  1. Choisissez la source (exactement une, obligatoire)
       ├── modèle analysé   formula_id        →  ignore l'analyse, génère maintenant (le plus rapide)
       ├── lien TikTok      tiktok_url        →  le backend télécharge + analyse + génère
       ├── vidéo téléchargée video (≤100 Mo, ≤ limite de rendu) →  le backend analyse + génère
       └── votre propre vidéo terminée source_asset_id   →  SWAP UNIQUEMENT : une de vos vidéos de riff/création terminées
            ↓
  2. Paramètres optionnels (tous avec valeur par défaut ; l'agent peut suggérer, ne force jamais)
       character     par défaut Auto (personne générée par IA) ; peut suggérer un personnage approprié selon l'intention du compte
                     (swap : optionnel ; pas de personnage = la personne d'origine reste. Un swap doit quand même changer
                      quelque chose : un personnage, un produit avec images, ou un content_anchor écrit)
       product       par défaut aucun (no_product) ; attacher un produit existant/nouveau pour en placer un
       visibility    par défaut on_camera ; pertinent uniquement lorsqu'un produit est attaché
       language      par défaut en ; candidats depuis GET /api/languages (actuellement en / es / pt / id / de / fr / it / ja / zh-CN)
                     (swap ignore language / visibility / ratios : la source les décide)
       content_anchor direction créative optionnelle ; l'agent peut en rédiger proactivement une pour révision
       user_hint     indice d'accroche optionnel ; utilisé uniquement pour une NOUVELLE source (ignoré pour un modèle)
            ↓
  3. Confirmez avant de soumettre (le seul blocage)  →  POST /api/riffs
            ↓  ↳ solde insuffisant renvoie HTTP 402 (structuré) ; gérez selon « Facturation et solde »
  4. Surveillez  GET /api/tasks/batch/{batch_id}  (toutes les 10-15 s)
            ↓
  5. Livrez  GET /api/assets → liens de téléchargement + légende + hashtags + récapitulatif de stratégie

Le seul blocage est la confirmation pré-soumission (l'engagement financier). Le personnage, le produit et le content_anchor sont des collaborations optionnelles et ne bloquent jamais le flux.

Points de terminaison en un coup d'œil :

Point de terminaisonObjectif
GET /api/auth/meVérifier l'état d'authentification
POST /api/skill/device/authorize · POST /api/skill/device/tokenConnexion en un clic (autorisation de périphérique ; pas de collage de jeton)
POST /api/riffsRiff unique (le point d'entrée de génération privilégié, quasi exclusif)
GET /api/formulasLister les modèles analysés (l'une des sources)
GET /api/formulas/{id}Résumé d'extraction (extraction_summary) d'un modèle (ce qui a été extrait)
POST /api/formulas/analyzeAbonnés uniquement — analyser une nouvelle source dans votre propre modèle sans générer (construire une bibliothèque)
POST /api/formulas/{id}/refresh-analysisRé-analyser l'un de vos propres modèles (obsolète, ou son indice était faux)
PATCH /api/formulas/{id}Renommer l'un de vos propres modèles ou modifier son user_hint (puis rafraîchir)
GET /api/charactersPersonnages numériques (liaison optionnelle) — la création est plafonnée, voir « Plafonds de création »
GET /api/products · POST /api/products · POST /api/products/{id}/imagesProduits + images de produits (placement optionnel) — la création est plafonnée
GET /api/settingsCapacités de déploiement + creation_limits de ce compte (vérification préalable avant de créer un personnage/produit/avatar) + credit_cover ({available, adapt, swap, trial} : la plus longue vidéo personnelle, en secondes entières, que le solde couvre dans chaque mode avec le moteur par défaut de ce mode ; citez-le en crédits et secondes, jamais en dollars)
GET /api/languagesLangues candidates pour la vidéo
GET /api/tasks/batch/{id} · GET /api/tasks/{id}Interrogation de la progression
GET /api/tasks · GET /api/tasks/statsLister / compter les tâches
POST /api/tasks/{id}/cancel · POST /api/tasks/{id}/retryAnnuler / réessayer
GET /api/assetsRécupérer les vidéos terminées (vidéo + légende + hashtags)
POST /api/pipeline/backfill · GET /api/pipeline/backfill/occupiedAjouter des formats d'image supplémentaires à un rendu déjà livré (recadrer) / lister les formats déjà produits
GET /api/usage/creditsSolde
GET /api/billing/plans · GET /api/billing/subscriptionCatalogue des forfaits / forfait actuel (pour vente incitative après 402)

Les paramètres complets et les réponses se trouvent dans « Référence API » ci-dessous.


Règles d'engagement (contraintes strictes)

L'agent ne soumet jamais par lui-même. Il s'arrête une fois pour obtenir un consentement explicite avant de soumettre. Tout le reste peut se poursuivre avec les valeurs par défaut.

À NE PAS FAIRE :

  • Soumettre automatiquement une tâche simplement parce que l'utilisateur a dit « riff ceci » (décider de la source + configuration est acceptable ; la soumission doit attendre le feu vert)
  • Considérer « choisir un personnage / choisir un produit » comme une étape obligatoire — le personnage par défaut est Auto, le produit par défaut est aucun ; utilisez les valeurs par défaut lorsque l'utilisateur n'a demandé ni l'un ni l'autre (un swap doit quand même changer au moins une chose, voir Étape 0)
  • Considérer la rédaction de content_anchor comme un blocage qui doit être itéré jusqu'à satisfaction de l'utilisateur avant de continuer (c'est une collaboration optionnelle)
  • Calculer vous-même un prix, ou divulguer le solde — chaque prix provient du serveur : GET /api/riffs/quote pour un riff adapt ou swap (n'importe quelle source) et credits_per_ratio depuis GET /api/pipeline/backfill/occupied pour des formats supplémentaires d'une vidéo que vous avez déjà. Une vidéo de création n'a pas de devis et va à la confirmation sans estimation. Le solde n'est évoqué que lorsque le devis indique qu'il ne couvre pas le prix (fits: false), sur un 402, avant une nouvelle tentative (qui facture la vidéo qu'elle doit rendre à nouveau, au maximum le prix total de la vidéo — voir POST /api/tasks/{task_id}/retry), ou lorsque l'utilisateur le demande
  • Réessayer automatiquement une tâche ayant échoué (une nouvelle tentative peut facturer des secondes de vidéo à nouveau ; l'utilisateur décide)
  • Conserver les informations sur le produit que l'utilisateur n'a pas explicitement confirmées
  • Appeler un point de terminaison réservé au staff ou sonder des chemins non listés ici

À FAIRE :

  • Verrouiller d'abord la source (l'une des trois ; en mode swap, également votre propre vidéo terminée) — la seule entrée obligatoire
  • Avant de soumettre, reformuler le plan (mode / source / personnage / produit+visibilité / langue / content_anchor, plus le prix de GET /api/riffs/quote pour un riff adapt ou swap, voir Étape 3) et demander « Soumettre ? » → sur confirmation, appeler POST /api/riffs
  • Sur HTTP 402, suivre « Facturation et solde » : transmettez topup_url textuellement, pas de nouvelle tentative, pas d'échec silencieux
  • Appeler GET /api/usage/credits uniquement lorsque l'utilisateur demande combien il lui reste, ou avant de proposer une nouvelle tentative (pour comparer le coût maximum possible au solde) ; un 402 contient déjà les deux nombres
  • Demander lorsque l'entrée est ambiguë plutôt que de deviner et de continuer
  • Signaler les erreurs honnêtement dès qu'elles se produisent ; ne jamais réessayer silencieusement
  • Sur une vidéo terminée, présenter uniquement le lien de téléchargement + la copie — ne jamais publier sur une plateforme

Jusqu'à ce que l'utilisateur dise « soumettre / générer / riff / go », vous êtes un collaborateur qui rédige et présente un plan — pas un exécuteur de commandes.

Qui fait quoi. Vous jugez et éditez : choisissez la source, rédigez content_anchor et user_hint, corrigez les sous-titres, et décidez si un résultat remplit son rôle. Le serveur mesure et génère : l'analyse, le timing des sous-titres (align_status) et la vidéo ; lisez ce qu'il rapporte au lieu de le deviner. Chaque étape payante (un nouveau riff ou une vidéo de création, une nouvelle tentative, un format supplémentaire) attend le feu vert de l'utilisateur. Convergez : une fois que la vidéo remplit son rôle, livrez-la et nommez ce qui est encore imparfait (une légende en retard d'un temps, un visage qui n'a pas complètement changé) au lieu de dépenser plus de rendus à la recherche d'une perfection zéro défaut.


Idée centrale : les trois couches de responsabilité (pourquoi content_anchor est la valeur de l'agent)

CoucheRôleVerrouillée parLiberté
Formule + squeletteGarantie de plancher — un mécanisme émotionnel + langage caméra validéÀ l'analyse du modèleAucune (la modifier annule la valeur du riff)
Personnage + produitConstantes de base — l'humain numérique + les faits du produitChoisis dans les paramètres (ou par défaut)Des choix différents = des constantes différentes, mais constantes au sein d'une tâche
content_anchorMoteur de plafond — quel angle d'argument de vente, quelle surface remplirAgent + utilisateur le rédigent (optionnel)Le seul degré de liberté stratégique

Le squelette de la formule décide quel chemin psychologique le spectateur emprunte ; content_anchor décide quel contenu spécifique remplit ce chemin. Les autres couches sont des constantes préexistantes, donc la valeur différenciée de l'agent est de fusionner « formule source × produit/compte × personnage » en une instruction créative concrète.


Workflow complet

Étape 0 : Adapt ou swap (adapt par défaut)

ModemodeCe qui resteCe qui changeChoisissez-le quand
Adapt (par défaut)adapt ou omisLa formule émotionnelle : accroche, rythme, temps fortsL'histoire, les scènes, le script, la langueL'utilisateur veut sa propre vidéo qui fonctionne comme la gagnante
SwapswapLa caméra, les coupes, le cadrage, l'action, le timing, le son et la forme du cadre de la sourceCe que l'utilisateur nomme : la personne (votre personnage, si vous en choisissez un), un produit, et tout ce que content_anchor nomme : le décor, une tenue, la formulation d'une répliqueL'utilisateur veut cette vidéo avec son personnage dedans (« même vidéo, mais moi », « mets mon personnage dans celle-ci »)

Règles de swap (appliquées par le backend) :

  • Un swap doit changer au moins une chose : un personnage (character_ids), un produit qui a des images (product_id ; un produit sans images ne change rien), ou un content_anchor non vide. Aucun des trois → 400 dont detail est une phrase localisée simple (en : « A swap needs at least one change: … » ; le corps ne porte pas de code d'erreur, transmettez donc detail plutôt que de faire une correspondance). Vérifié pour chaque source de swap, avant que quoi que ce soit ne soit analysé ou facturé.
  • Le personnage est optionnel. Sans personnage, la personne d'origine de la source reste (son vrai visage est dans la sortie) ; il n'y a pas de personne Auto en swap. Une tâche par personnage, comme pour adapt ; pas de personnage = une tâche. Un personnage choisi doit avoir un avatar approuvé (has_any_active_avatar=true), comme pour adapt. Si l'utilisateur veut une personne différente, recommandez de choisir un personnage : une personne modifiée uniquement par des mots dans content_anchor n'a pas d'image de référence, donc le visage peut différer entre les plans (et sur Seedance 2.0, la voix reste celle de l'original).
  • Vérifiez l'avatar avant un swap payant avec un personnage. L'échange de visage fonctionne à partir de l'image de l'avatar du personnage (reference_image dans GET /api/characters ; récupérez ${BASE_URL}${reference_image} avec le cookie de session, comme file_url d'une vidéo). Ce qui fonctionne

…

[traduit pour la traduction]

Skills associés