Communitygithub.com

ericrisco/rsc-harness

À utiliser lorsqu'un short vertical est filmé ou scénarisé et que vous avez besoin des éléments de copie pour le formulaire de publication et de la couverture qui gagnent dans le fil d'actualité — la ligne d'accroche, le texte à l'écran de la première image, la légende orientée recherche, un ensemble de hashtags précis et l'image de couverture ; il apprend de ce qui a performé via le journal 02-DOCS. N'invente PAS l'idée (c'est `shortform-ideation`), NE scénarise NI ne dirige les coupes (c'est `video-shorts`), N'exécute PAS le montage (c'est `shortform-editing`), NE planifie PAS la publication (c'est `social-publisher`).

Qu'est-ce que rsc-harness ?

Ce SKILL.md définit un système de packaging de contenu court (Short-Form Packaging) conçu pour optimiser la survie et la performance d'une vidéo verticale dans les fils d'actualité des réseaux sociaux (TikTok, Reels, Shorts). L'objectif principal est de produire les cinq éléments clés de la copie de publication et de la couverture (accroche, texte à l'écran, légende, hashtags, couverture) en se basant sur des données de performance historiques (journal 02-DOCS) plutôt que sur des intuitions. L'outil est strictement délimité : il n'invente pas d'idées, n'écrit pas de scripts, ne réalise pas de montage et ne planifie pas de publications ; il se concentre uniquement sur l'emballage final qui sera vu par le public. Le skill met l'accent sur deux métriques clés : la rétention en début de vidéo (70%+ après 3 secondes) et les envois/partages (Sends & Saves), considérés comme plus importants que les likes. Il fonctionne sur les plateformes TikTok, Instagram Reels et YouTube Shorts.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ericrisco/rsc-harness/tree/HEAD/skills/shortform-packaging

Demander à votre IA préférée

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

Documentation

Packaging de contenu court

Vous écrivez les mots et choisissez l'image qui habillent un short vertical terminé ou scénarisé pour qu'il survive dans le fil d'actualité. Le clip existe déjà — votre travail est la copie de formulaire de publication et la couverture qui décident si un scrollant s'arrête, termine la vidéo et l'envoie à un ami. Vous n'êtes pas l'idée, pas le script, pas le montage, pas la planification. Un excellent clip meurt sur un mauvais emballage ; un emballage testé multiplie les chances d'un bon clip.

Vous optimisez en fonction des métriques mesurées de rétention et de partages tirées du journal 02-DOCS du compte — pas d'une intuition, pas du dernier fil sur les "accroches virales".

Ce que vous produisez

Cinq artefacts plus une entrée de feedback, à chaque fois :

  1. Une ligne d'accroche — l'ouverture parlée/écrite, 4-7 mots, qui doit survivre à la 3e seconde.
  2. Un texte à l'écran de la première image — la ligne incrustée qu'un scrollant sans son lit avant toute décision audio ; 2-3 variantes à tester, chacune ≤7 mots.
  3. Une légende — orientée recherche, avec le mot-clé en premier, la phrase clé en début de ligne.
  4. Un ensemble de hashtags — 3-5 tags signalant le sujet, jamais un dump de découverte.
  5. Une image de couverture + superposition — l'image qui devient la vignette dans la grille/le shelf Shorts, plus sa superposition de 3 à 6 mots.
  6. Une entrée de feedback 02-DOCS — ce qui a été publié, la métrique qui a bougé, ce qui a gagné.

Précondition (ne pas sauter). La vidéo doit être filmée ou scénarisée, et l'idée/l'angle doit être décidé. S'il n'y a pas de script, orienter vers video-shorts. S'il n'y a pas d'idée arrêtée, orienter vers shortform-ideation. N'inventez rien ici — emballer un short non décidé revient à deviner l'accroche, le mot-clé et le public en même temps.

Règle zéro : emballer pour le test de seed et l'envoi

Chaque choix ci-dessous sert exactement deux résultats. Gardez-les à l'esprit :

  • Le test de seed est tout le jeu. TikTok et Shorts poussent chaque publication vers un petit public test d'abord ; une faible rétention d'introduction associée à un fort taux de swipe-away tue la distribution avant qu'elle ne se répande. La rétention d'introduction (avoir dépassé 3 s) de 70%+ est la barre, et les premières ~3 secondes portent la plus grande partie de l'influence sur le fait qu'un clip soit terminé ou non. Donc, l'accroche + le texte de la première image + la couverture sont la copie au plus fort effet de levier sur l'ensemble du post.
  • Les envois et les sauvegardes sont la monnaie, plus importants que les likes. Les facteurs de classement des Reels d'Instagram sont le temps de visionnage, les likes par portée et les envois par portée (partages en DM) ; Mosseri a répété à plusieurs reprises que les envois et les sauvegardes signalent plus d'intention que les likes, alors traitez-les comme étant plus importants que les likes. Emballez pour "Je dois envoyer ça à quelqu'un", pas pour des likes de vanité.

Commencez par les bases

Avant d'écrire un mot, lisez le compte. Ignorer cela produit une copie générique dans la voix d'un inconnu qui contredit ce qui a déjà gagné.

  1. Lisez 02-DOCS/wiki/shortform/ pour la voix de la marque et les emballages précédents.
  2. Lisez le journal de feedback de performance — quelles accroches, couvertures et hashtags ont déjà amélioré la rétention d'introduction et les envois. Reproduisez la forme du gagnant.
  3. Récupérez l'idée/angle décidé(e) à partir de la sortie de shortform-ideation si elle existe.
  4. Pas de script ou pas d'angle arrêté ? Orientez VERS L'EXTÉRIEUR (voir Transmissions). N'inventez jamais ici.

Persistez l'emballage sous 02-DOCS/wiki/shortform/ et les résultats de test bruts sous 02-DOCS/raw/shortform/. L'arborescence wiki shortform/ est un bundle OKF v0.1 partagé avec les frères tiktok-api et shortform-strategy : chaque fichier .md d'emballage persisté commence par un frontmatter YAML portant un type: shortform-package non vide (plus les title/tags/timestamp recommandés), et toute référence croisée utilise des liens markdown standard, jamais [[wikilinks]]. Le journal de feedback brut sous 02-DOCS/raw/shortform/ est raw/, pas wiki/ — pas de frontmatter requis. L'intégralité du frontmatter et de la profondeur du motif se trouve dans references/package-templates.md.

La décision en deux secondes

Un scrollant rencontre votre short dans l'un de deux états, et vous devez concevoir pour les deux :

  • Depuis le fil d'actualité/FYP : l'image 1 est jouée sans son. ~60% regardent sans son, donc le texte à l'écran de la première image porte l'accroche — il est lu avant toute décision audio.
  • Depuis une grille de profil ou le shelf Shorts : ils voient d'abord l'image de couverture, recadrée et silencieuse.

Ainsi, trois artefacts doivent dire la même promesse avec les mêmes mots : l'accroche parlée, le texte à l'écran de la première image (son jumeau silencieux) et la superposition de couverture. Co-concevez-les ; ne les laissez jamais diverger.

Ligne d'accroche + texte à l'écran

Les 3 secondes qui décident de la distribution. Règles, chacune avec sa raison :

  • 4-7 mots. Plus long, et le scrollant sans son swipe avant de finir la lecture.
  • Commencez par la promesse ou la tension, pas par la mise en place. Le bénéfice ou les enjeux passent en premier ; le contexte peut attendre la légende.
  • Le texte à l'écran est le jumeau silencieux de l'accroche parlée — reformulez l'accroche sous forme de texte incrusté pour que la majorité sans son la comprenne. Gardez-le dans les zones de sécurité (loin de la barre d'état supérieure et de l'interface utilisateur inférieure : légende, boutons, cible de tap du profil).
  • Émettez un ENSEMBLE de 2-3 variantes, jamais une seule. Vous publiez une hypothèse à mesurer sur le public test, pas une supposition à défendre.
MauvaisBonPourquoi
"Hé les gars, aujourd'hui je voulais parler de...""J'ai supprimé mon app de tâches. Voici pourquoi."Promesse dès le début ; survit à la 3e seconde.
"Regardez jusqu'à la fin !""La dernière étape est celle que personne ne fait."Boucle ouverte avec un enjeu concret, pas une supplique.
À l'écran : (aucun — repose sur l'audio)À l'écran : "3 apps qui ont remplacé Notion"Porte l'accroche pour les 60% sans son.
L'accroche dit X, le texte à l'écran dit YL'accroche et le texte à l'écran disent les mêmes 5 motsPromesse jumelle, pas de dérive.

La bibliothèque complète de motifs (boucle ouverte · nombre · contraire · enjeux · point de vue · avant/après) avec des réécritures Mauvais→Bon se trouve dans references/package-templates.md.

La légende

La légende est désormais un champ de classement dans la recherche, pas une ligne jetable. Mosseri liste les légendes comme un facteur de classement des Reels ; la recherche TikTok et Instagram lit le langage de la légende comme le texte d'une page. Règles :

  • Commencez la première phrase par la phrase de mot-clé réelle qu'un spectateur rechercherait — pas un teaser, pas une question. Une première ligne menée par un mot-clé est ce qui fait apparaître le clip dans la recherche intégrée à l'application et dans le rail "associé" ; une ligne de teaser n'apparaît nulle part.
  • Seuls les ~100-150 premiers caractères sont visibles avant le "plus". Mettez le mot-clé, la valeur et tout code/lien ici. Le reste ne sera peut-être jamais vu.
  • Zone idéale ~150-300 caractères pour le contexte plus l'engagement ; allez jusqu'à 500+ uniquement pour un post délibérément éducatif/SEO. Les limites strictes (TikTok 4 000, Reels 2 200) sont sans importance — la première ligne fait le travail.
  • Terminez sur un bénéfice valant un enregistrement/un envoi et un seul CTA doux. "Envoyez ceci à l'ami qui en a besoin" bat "likez et abonnez-vous".

Choisissez la forme de la légende en fonction de la demande :

Si l'objectif est...Forme de la légende
Être classé dans la recherche intégrée (contenu intemporel, tutoriel)Phrase de mot-clé d'abord → valeur → CTA doux. Visez 200-400 caractères.
Engagement sur un clip opportun/divertissantLigne de bénéfice percutante + invite à envoyer. Gardez ~150 caractères.
MauvaisBon
"attendez la suite 👀 vous n'allez pas y croire""3 templates Notion qui ont remplacé mon app de tâches (liens gratuits ci-dessous)"
"nouvelle vidéo !! allez voir 🔥🔥""Comment préparer une semaine de shorts en un après-midi — le workflow exact"

Hashtags

Les règles ont changé ; le vieux dump de 30 tags est désormais un handicap.

  • 3-5 hashtags. Jamais plus. Instagram limite désormais les posts/Reels à 5 (Mosseri, en cours de déploiement en 2026) et déclare que les hashtags "catégorisent le contenu pour l'algorithme" — ils n'augmentent pas la portée. La meilleure pratique TikTok est également 3-5 (CapCut, l'éditeur propre à ByteDance) ; 10+ signale du spam et donne des signaux contradictoires à l'algorithme.
  • Signal de sujet, pas de découverte. Choisissez des tags spécifiques qui étiquettent ce qu'est la vidéo, pas des appâts à portée large comme #fyp #viral #foryou.
  • Adaptez par plateforme. Même clip, mais adaptez le public de recherche de chaque plateforme — un tag qui se classe sur TikTok peut être du bruit sur Reels.
Mauvais :   #fyp #foryou #viral #trending #productivity #notion #app #tech #life #2026 ... (22 autres)
Bon :  #notiontemplates #productivitytips #notionsetup

Image de couverture

La couverture est la vignette de la grille/recherche/shelf — elle vend la relecture et la visite du profil, et elle n'est pas ce qui est joué dans le fil d'actualité. Choisissez-la et spécifiez-la :

  • Choisissez une image à fort mouvement, fort contraste ou à émotion maximale — un visage en pleine expression ou le bénéfice visuel. Évitez une image plate, au milieu d'une phrase.
  • Respectez les recadrages. Une couverture Reels s'affiche en plein 9:16 (1080×1920) dans l'onglet Reels, mais la grille de profil la recadre en 3:4 (1080×1440) — Instagram a supprimé les ~240px du haut et du bas de l'image 1080×1920 lorsqu'il a déplacé la grille en 3:4 en 2025. Le fil d'actualité recadre différemment à nouveau (4:5, 1080×1350). La seule région qui survit à tous les recadrages est le carré central 1:1 (1080×1080) — alors gardez tout le texte de la couverture à l'intérieur de ce carré central et vous serez en sécurité sur la grille, le fil d'actualité et l'onglet.
  • Ajoutez 3-6 mots de superposition — les mêmes mots que l'accroche, à fort contraste.

Liste de vérification de la couverture :

  • L'image a du mouvement/contraste/un visage ou montre le bénéfice (pas une image plate en milieu de séquence)
  • La superposition fait 3-6 mots et correspond à la ligne d'accroche
  • Le texte de la superposition se trouve à l'intérieur du carré central 1:1 (la seule région qui survit au recadrage de la grille 3:4, au recadrage du fil 4:5 et à l'onglet 9:16)
  • Le texte évite la barre d'état supérieure et l'interface utilisateur inférieure

La boucle d'apprentissage (02-DOCS)

C'est le cœur qui fait que la compétence se cumule. Lisez les gagnants avant d'écrire ; ajoutez un résultat après avoir publié. Clé du journal sur les métriques qui font bouger la distribution — PAS les likes :

- publié : "2026-06-02 / faceless productivity TikTok"
  accroche : "J'ai supprimé mon app de tâches. Voici pourquoi."
  texte_ecran : "3 apps qui ont remplacé Notion"
  superposition_couverture : "J'ai supprimé mon app de tâches"
  hashtags : ["#notiontemplates", "#productivitytips", "#notionsetup"]
  retention_intro : 0.74   # a dépassé 3s — la barre est 0.70
  envois_par_portee : 0.018  # partages en DM, la monnaie de l'économie de partage
  sauvegardes : 312              # plus important que les likes (signal d'intention)
  a_gagne : "le texte à l'écran mené par le nombre a battu la variante de question sur la rétention d'introduction"

Le schéma rempli et un exemple adapté par plateforme se trouvent dans references/package-templates.md. Lorsque vous écrivez le prochain emballage, ouvrez d'abord le journal et reflétez la forme qui a gagné.

Testez par ensembles, publiez sur le trio

Les spécifications sont partagées — 9:16, 1080×1920, MP4 H.264/AAC — donc un emballage se réutilise sur TikTok, Reels et Shorts. Mais adaptez les mots-clés de la légende et les hashtags par public de recherche de chaque plateforme, et traitez le carré de sécurité 1:1 comme le plus critique sur Instagram. Publiez 2-3 variantes d'accroche + texte à l'écran + couverture, lisez laquelle a amélioré la rétention d'introduction et les envois, enregistrez-la, répétez.

Transmissions

Orientez vers l'extérieur dès que la demande quitte la copie de formulaire de publication et la couverture. L'indice : si c'est l'un des cinq artefacts ci-dessus, c'est ici ; sinon, c'est un frère.

DemandeOrienter vers
Inventer l'idée / le sujet / l'angle pour le shortshortform-ideation
Plan au niveau du compte : niche, cadence, plateformes, croissanceshortform-strategy
Écrire le script parlé / la feuille de rythme, diriger les coupesvideo-shorts
Exécuter le montage — incrustation de la légende, images de couverture, synchronisation audioshortform-editing
Planifier / publier en croisé le short terminésocial-publisher
Publier par programmation via le Graph/API de la plateformetiktok-api / instagram-api
Titre/description/tags pour une vidéo YouTube longue duréeyoutube-packaging
Définir le ton de marque durable réutilisé sur tout le contenubrand-voice

Ligne claire vs video-shorts : ce frère possède le texte à l'écran interne de chaque temps dans le cadre du récit. Vous possédez la couche d'emballage — la superposition unique d'accroche de la première image, la légende, les hashtags et la couverture — et vous traitez l'existence du script comme une précondition.

Anti-patrons

Anti-patronFaites plutôt
La légende commence par un teaser ("attendez la suite 👀")Commencez la première phrase par la phrase de mot-clé recherchée.
Publier une seule accroche au lieu d'un ensembleÉmettez 2-3 variantes d'accroche + texte à l'écran pour tester sur le seed.
Déverser 15-30 hashtags3-5 tags de sujet spécifiques ; IG limite à 5, la meilleure pratique TikTok est 3-5.
CTA appât à like ("explosez ce like")Un bénéfice d'enregistrement/envoi — les envois et les sauvegardes l'emportent sur les likes.
Texte de couverture en dehors du carré central 1:1Gardez la superposition à l'intérieur du carré central — la bande qui survit aux recadrages de la grille 3:4, du fil 4:5 et de l'onglet 9:16 — loin de l'interface utilisateur.
Texte à l'écran qui ne correspond pas à l'accrocheFaites du texte à l'écran le jumeau silencieux — mêmes mots.
Écrire à l'aveugle, ignorer le journal 02-DOCSLisez d'abord les gagnants précédents ; reproduisez la forme gagnante.
Emballer avant qu'un script/une idée existeOrientez d'abord vers video-shorts / shortform-ideation.
Même légende copiée-collée sur chaque plateformeAdaptez les mots-clés et les hashtags par public de recherche de chaque plateforme.
Enregistrer les likes comme métrique de succèsEnregistrez la rétention d'introduction, les envois par portée et les sauvegardes.

Vérifier

scripts/verify.sh <package-file> est un lint en lecture seule, sans réseau sur un brouillon d'emballage : l'ensemble d'accroches a ≥2 variantes ; le texte à l'écran existe et fait ≤7 mots par ligne ; la première phrase de la légende fait ≤~150 caractères et ne commence pas par un teaser interdit ; le nombre de hashtags est de 3-5 ; une image de couverture + superposition est présente ; et un bloc de feedback 02-DOCS existe avec retention_intro, envois_par_portee et sauvegardes. Un fichier propre ou vide sort avec le code 0 — jamais un faux échec. Voir evals/README.md pour savoir comment les cas sont exécutés.

Individual skills in this repo

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

ericrisco/rsc-harness

Use when writing the words on a single conversion page — the hero headline and subhead, the offer, the proof and testimonials, and one primary CTA — or diagnosing a page that gets traffic and does not convert, as a copy problem rather than a layout one. NOT the paid ad that drives the click (that is `ads`), NOT the visual layout the words sit in (that is `design`), NOT the experiment that picks the winning variant (that is `ab-testing`).

ericrisco/rsc-harness

Use when you need to render an actual video file with Remotion — React compositions, the Composition/Sequence/TransitionSeries graph, transitions, burned-in word-by-word captions from a transcript, automatic silence removal, b-roll overlays, headless CI renders, and a final MP4 or MOV. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT mastering audio to LUFS or building an RSS feed (that is `podcast`), NOT structuring the narrative arc (that is `course-storytelling`).

ericrisco/rsc-harness

Use when you have raw 9:16 footage and need it cut into a post-ready vertical short — dead air removed, fast jump cuts, karaoke word-by-word burned-in captions from a transcript, cuts and zooms snapped to the music beat, safe-area placement so captions clear the platform UI, and a platform-correct MP4 export. NOT writing the script, hook, beats or caption text (that is `video-shorts`), NOT building a Remotion React composition codebase (that is `remotion-video`), NOT deciding when or where to post (that is `social-publisher`).

ericrisco/rsc-harness

Use when a Reels/TikTok/Shorts account needs its next video ideas scored into a ranked backlog, grounded in its own performance log plus dated trending sounds, each bet logged so its outcome feeds the next batch. NOT scripting a chosen idea (that is `video-shorts`), NOT pillars or cadence (that is `shortform-strategy`), NOT packaging a finished cut (that is `shortform-packaging`).

ericrisco/rsc-harness

Use when the unit of work is a TikTok/Reels account, not one clip: positioning, sustainable cadence and format mix, ride-or-skip on a trend or sound, recurring series, diagnosing a flat account, and the dated learning loop. NOT the single script or hook variants (that is `video-shorts`), NOT the idea backlog (that is `shortform-ideation`).

ericrisco/rsc-harness

Use when planning a posting schedule, building a multi-platform content calendar, or reshaping one source asset into channel-native posts across X, LinkedIn, Instagram, Threads, Bluesky, TikTok, Facebook or YouTube — cadence, best-time slots, per-platform format limits, API publish caps, and a dated CSV or JSON calendar a scheduler can import. NOT the brand voice the posts speak in (that is `brand-voice`), NOT the editorial strategy of what to make (that is `content-engine`).

ericrisco/rsc-harness

Use when connecting a real TikTok account to code via the Content Posting, Display and Business Account APIs — OAuth, chunked video publish with status polling, and pulling views, watch time and impression sources, then logging that performance into the wiki as a dated feedback record. Covers short-lived tokens breaking a cron, unverified pull-from-URL ownership, and rate limits. NOT what to post or how to package it (that is `shortform-strategy` and `shortform-packaging`).

ericrisco/rsc-harness

Use when scripting or directing the edit of a single vertical short that has to hold attention from the first frame — turning a topic, a clip or a long video into a shot-by-shot script and an edit decision sheet, fixing a hook that dies in second three, generating hook variants to test, and planning cuts and on-screen text. NOT scheduling or cross-platform cadence (that is `social-publisher`), NOT running the editorial calendar (that is `content-engine`), NOT defining the durable brand tone (that is `brand-voice`).

ericrisco/rsc-harness

Use to judge whether a short-form clip is worth publishing — scores a reel, short or podcast excerpt 0-100 on ten weighted criteria with automatic penalties, then ranks a batch and says where the cut-off falls. Run it on transcript candidates before rendering. NOT writing the hook or caption (that is `shortform-packaging`), NOT inventing the idea (that is `shortform-ideation`), NOT executing the edit (that is `shortform-editing`).

Skills associés