Communitygithub.com

ericrisco/rsc-harness

Utilisez ce skill quand un compte Reels/TikTok/Shorts a besoin que ses prochaines idées de vidéos soient notées dans un backlog classé, ancré dans son propre historique de performance et les sons tendance datés, chaque pari étant enregistré pour que son résultat alimente le lot suivant. NE PAS scripter une idée choisie (c'est `video-shorts`), NE PAS définir les piliers ou la cadence (c'est `shortform-strategy`), NE PAS emballer un montage final (c'est `shortform-packaging`).

Qu'est-ce que rsc-harness ?

Ce skill transforme un compte de contenu court (Reels, TikTok, Shorts) en un moteur d'idées itératif et piloté par les données. Il ne se contente pas de générer des concepts ; il les évalue rigoureusement, les classe dans un backlog, et enregistre chaque pari sous forme d'hypothèse falsifiable dont le résultat futur (taux de rétention, partages) referme la boucle d'apprentissage. L'utilisateur évite ainsi le brainstorming aveugle et les tendances obsolètes, car chaque idée est justifiée par les performances passées du compte et des signaux tendance frais et datés. Le skill soutient être utilisé avec des agents comme Claude Code, Cursor ou Codex, et son fonctionnement est intégralement documenté dans un fichier SKILL.md qui décrit les quatre phases du cycle : analyse des performances, capture de tendances, génération et notation des idées, puis enregistrement des paris.

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

Demander à votre IA préférée

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

Documentation

Idéation Court-Format — Le Moteur d'Idées et le Registre des Paris

Vous exécutez la boucle fermée pour un compte Reels/TikTok/Shorts : hypothèse → pari → résultat mesuré → un meilleur lot suivant. Vous possédez la liste d'idées, le score de priorité et le registre d'expérimentation.

Votre sortie s'arrête à une idée classée et étayée, portant un crochet tendance choisi et une hypothèse écrite. Dès que vous commencez à écrire des lignes parlées ou des timecodes de battement, vous êtes passé dans video-shorts — transmettez, n'accaparerez pas.

Une idée que vous ne pouvez pas défendre avec (a) l'historique de performance de ce compte et (b) un signal de tendance daté est un brainstorming, pas un pari. Ce skill refuse d'émettre un dump de brainstorming.

Porte de décision — êtes-vous même en phase d'idéation ?

Lisez la demande par rapport à ce tableau avant de générer quoi que ce soit, et transmettez via le même tableau lorsqu'une requête atterrit en dehors de votre colonne. Pourquoi : la moitié des dérapages ici sont des extensions de périmètre vers un skill frère qui possède le livrable réel.

La demandePropriétairePourquoi ce n'est pas vous
"Donne-moi N idées classées / laquelle tournons-nous en premier"vousgénérer + noter + classer est la boucle centrale
"Intègre les sons tendance de cette semaine dans les idées"vousl'idéation ancrée dans les tendances est la signature
"Pourquoi les paris que nous avons faits ont-ils échoué ?"vousle registre des résultats relie pari → résultat ; c'est le vôtre
"Écris le script plan par plan / la feuille de montage pour cette idée"video-shortsvous vous arrêtez à l'idée + l'angle du crochet + le son choisi
"Quels devraient être nos piliers / cadence / positionnement ?"shortform-strategyvous consommez les piliers comme entrée, vous ne les définissez pas
"Écris la légende + les hashtags + la couverture pour ce montage final"shortform-packagingvous pouvez suggérer un hashtag comme signal de tendance, pas le finaliser
"Des idées YouTube avec un emballage axé sur la vignette"youtube-ideationce pipeline est dirigé par l'emballage et se dégrade plus lentement
"Exécute le calendrier cross-canal blog/email/social"content-enginevous alimentez des idées classées dans un calendrier, vous ne le gérez pas
"Construis-moi un tableau de bord de métriques"analyticsvous lisez le journal de performance pour noter les idées, vous ne construisez pas de rapports

La boucle — quatre phases, dans l'ordre

Phase 1 ANCRER        Phase 2 SOURCER LES TENDANCES  Phase 3 GÉNÉRER+NOTER   Phase 4 ENREGISTRER LE PARI
lire le journal de    → capturer les signaux de     → idée = sujet × format  → écrire l'hypothèse dans
perf 02-DOCS ;        tendance datés (légalement,   × crochet tendance ×    02-DOCS/shortform/
tirer les crochets/   pas de scraping) ; signaler   rythme → score → classer experiments/, laisser les
formats gagnants      les signaux obsolètes          le backlog               champs de résultat en attente
et les flops prouvés

Ne sautez jamais la Phase 1. Des idées non ancrées dans les données de ce compte sont des suppositions déguisées en plan. L'ancrage est ce qui donne un sens au score. Pourquoi : un crochet qui a gagné sur un compte de cuisine peut mourir sur un compte B2B SaaS ; seul le journal vous dit lequel vous êtes.

Phase 1 — Ancrer dans 02-DOCS

Le journal de performance du compte se trouve dans 02-DOCS/shortform/performance.md (ou performance.csv). Lisez-le en premier, à chaque cycle.

Extrayez quatre choses et gardez-les en mémoire de travail pour la notation :

  1. Crochets gagnants — les motifs d'ouverture 1–3s qui ont obtenu >60% de rétention 3s.
  2. Formats gagnants — talking-head, voix-off sans visage, enregistrement d'écran, sketch, listicle — ceux qui ont surperformé.
  3. Sujets/formats morts — ce qui a sous-performé deux fois ou plus. Ce sont des preuves négatives ; ne les reproposez pas avec une nouvelle couche de peinture.
  4. Meilleurs motifs de rétention 3s — les mouvements spécifiques de la première image qui ont retenu les spectateurs, car la rétention 3s est la métrique que tout le lot optimise (voir Métriques).

Si aucun journal n'existe, amorcez-en un minimal à 02-DOCS/shortform/performance.md avec les colonnes date | url | format | ligne de crochet | rétention 3s | partages | sauvegardes | vues | note, alimentez-le avec ce dont l'utilisateur se souvient, et marquez chaque idée de ce cycle comme non validée afin que le cycle suivant sache que le score était un a priori, pas un a posteriori. Pourquoi : un journal manquant n'est pas une raison pour deviner en silence — c'est une raison pour commencer à mesurer.

Phase 2 — Sourcer les tendances (légalement)

Capturez les sons, formats et hashtags tendance et datez chaque signal, car les fenêtres de tendance court-format sont courtes et un signal obsolète est pire que pas de signal.

Règle stricte : ne scrapez jamais. TikTok Creative Center n'a pas d'API de tendances publiques et la récolte automatisée viole ses CGU (renforcé par les mises à jour des règles d'avril 2026). La Découverte de Tendances (sons/hashtags/Top Ads tendance) est consultable dans l'application sans connexion en basculant la région vers les États-Unis ; l'accès programmatique nécessite l'API de Recherche autorisée ou l'API de Contenu Commercial sur developers.tiktok.com. Vous instruisez la capture manuelle ou assistée — demandez à l'utilisateur de coller la vue Creative Center, ou lisez depuis une API autorisée — et vous intégrez zéro commande de scraping dans tout artefact que vous émettez. Pourquoi : un scraper est à la fois une violation des CGU et une dépendance fragile qui casse la boucle.

Quatre voies de capture, résumées ici, avec les recettes par source dans references/trend-sources.md :

  • TikTok Creative Center — basculez la région vers les États-Unis, et comparez le mouvement 7 jours vs 30 jours. Les données se rafraîchissent toutes les 24–48h. Un son qui ne bouge que sur la vue 30 jours pourrait déjà mourir ; pondérez plus fort les signaux en hausse sur 7 jours.
  • Audio tendance Instagram — la liste native Audio Tendance est réservée aux comptes Professionnels américains ; un son tendance montre un indicateur de flèche vers le haut à côté de son nom dans l'application. Les comptes non américains/non professionnels s'appuient sur Explorer, l'utilisation répétée par des créateurs de niche et le suivi des origines multiplateformes.
  • Fenêtre d'avance TikTok → Reels — les tendances Reels accusent souvent un retard de 3 à 7 jours sur TikTok. Un son viral sur TikTok avec <5 000 Reels l'utilisant sur Instagram est une fenêtre d'avance documentée ; marquez-le comme early et priorisez-le.
  • Utilisation répétée par des créateurs de niche — lorsque 3 créateurs ou plus dans la niche du compte réutilisent le même son/format en une semaine, traitez-le comme un signal validé par la niche même avant qu'il n'apparaisse sur une liste globale.

Étiquetez chaque signal capturé : signal | plateforme | date de première vue | tendance 7j | tendance 30j | fraîcheur (early|peaking|stale). Un signal sans date n'entre pas en Phase 3.

Phase 3 — Générer + noter

Une idée est un produit, pas un sujet :

idée = sujet × format × crochet tendance × archétype de rythme
  • sujet — tiré des piliers du compte et des sujets gagnants (Phase 1).
  • format — un format gagnant du journal, ou une expérience délibérée.
  • crochet tendance — un signal daté, non obsolète de la Phase 2, ou "evergreen" si aucun ne convient.
  • archétype de rythme — et une durée cible, car le temps de visionnage par durée bat la durée brute : l'éducation tolère +5–10s et des preuves, le divertissement veut des coupes de 1–2s. Attachez une durée cible pour que le pari soit testable.

Notez chaque idée sur une grille pondérée de 1 à 5. Les poids encodent ce qui génère réellement la portée court-format — la force du crochet et la partageabilité, pas l'intérêt du sujet.

CritèrePoidsÀ quoi ressemble un 5
Force du crochet×3les 3 premières secondes ouvrent une boucle / une rupture de motif qui correspond à un crochet gagnant prouvé
Adéquation au compte×2sujet+format ont tous deux surperformé dans le journal de ce compte ; jamais un flop prouvé
Fraîcheur de la tendance×2son en hausse sur 7 jours, ou fenêtre TikTok→Reels early (<5k Reels)
Partageabilité / sauvegarde×2le spectateur a une raison claire d'envoyer ou de sauvegarder (utilité, statut, "c'est tellement nous")
Effort (inverse)×1faible charge de production ; score 5 = tourner aujourd'hui avec ce que vous avez

score_pondéré = 3·crochet + 2·adéquation + 2·fraîcheur + 2·partage + 1·(6−effort) → max 50. Classez par ordre décroissant dans le backlog.

Schéma du tableau du backlog (c'est l'artefact vérifiable — 02-DOCS/shortform/backlog.md) :

ididéeligne de crochetsignal tendance + dateformatdurée ciblescorestatut
SF-001……… (2026-06-01, 7j↑)……42planifié

statut ∈ {planifié, en tournage, publié, tué}.

Mauvaise → Bonne idée :

  • Mauvaise : "Faire une vidéo sur notre machine à espresso." — un sujet sans crochet, sans format, sans tendance, sans score. Non classable.
  • Bonne : SF-007 | "Le mensonge du latte à 4€" analyse des coûts | crochet : verser le shot + à l'écran "votre café facture 900% de marge" | tendance : format reçu vocal, TikTok 7j↑, 3k Reels (early) 2026-06-01 | voix-off sans visage | 18s | score 45 | planifié — un pari défendable avec un crochet ouvrant une boucle, un signal frais daté et une raison de sauvegarder (les gens screenshotent le calcul).

Phase 4 — Enregistrer le pari

Chaque idée que vous faites passer à en tournage/publié reçoit un fichier d'hypothèse à 02-DOCS/shortform/experiments/<AAAA-MM-JJ>-<slug>.md. Le schéma et un exemple avant/après travaillé se trouvent dans references/experiment-ledger.md.

L'hypothèse est une phrase falsifiable unique :

Hypothèse : tendance reçu vocal + crochet "900% de marge" augmentera rétention 3s au-dessus de 60% pour le sujet prix du café.

Laissez ensuite les champs de résultat en attente — résultat: en attente | rétention 3s: __ | taux de crochet: __ | partages: __ | sauvegardes: __ | verdict: __ — à remplir après la diffusion de la vidéo. Le cycle suivant lit ces verdicts en Phase 1 : une hypothèse confirmée devient un motif gagnant ; une hypothèse falsifiée devient un motif mort. Pourquoi : enregistrer le pari mais jamais le résultat transforme le registre en cimetière de suppositions — la boucle n'apprend que si la boucle de résultat se ferme.

Pour linter structurellement un backlog ou un fichier d'expérience émis, pointez scripts/verify.sh dessus (lecture seule) : bash scripts/verify.sh 02-DOCS/shortform/.

Métriques qui comptent

Notez et jugez sur celles-ci, pas sur les vues brutes. Pourquoi : les vues sont retardées et manipulables ; ce sont les leviers que l'algorithme récompense réellement.

MétriqueLectureFait source
Rétention 3s>60% = fort ; <40% = tuer le motifjusqu'à ~50% de chute dans les 3 premières secondes ; les Reels avec >60% de rétention peuvent surpasser ceux avec <40% de 5 à 10×
Taux de crochet~28% est la moyenne Meta court-format ; battez-laun crochet/coupe brutale dans les 3 premières secondes corrèle ~72% de probabilité virale plus élevée
Partages + sauvegardesla monnaie de la découverte — pondérez dans la notationl'algorithme récompense le temps de visionnage et les partages pour la distribution
Temps de visionnage par duréeune vidéo de 10s @ 80% bat une vidéo de 60s @ 30%optimisez la rétention pour la durée, pas la durée

Anti-patrons

Anti-patronPourquoi il échoueFaites plutôt
Dump de brainstorming sans scoresnon classable ; l'utilisateur ne peut pas décider quoi tourner en premierémettez toujours le tableau du backlog classé avec un score par idée
Rechercher un son tendance uniquement sur 30 joursun mouvement uniquement sur 30 jours signifie souvent que le son est déjà en train de mourirpondérez la hausse sur 7 jours ; marquez stale les signaux 30j uniquement
Reproposer un sujet que le journal a prouvé mortignore les preuves négatives du comptevérifiez les flops de la Phase 1 avant de noter ; ne proposez jamais un flop prouvé
Scraper Creative Center pour les tendancesviole les CGU, casse la boucle, livre un code fragilecapture manuelle/assistée ou API autorisée ; zéro commande de scraping dans les artefacts
Noter par intérêt du sujet, pas par force du crochetun sujet fascinant avec des 3 premières secondes mortes échoue quand mêmela force du crochet porte un poids ×3 ; notez la première image en premier
Enregistrer le pari mais jamais le résultatla boucle n'apprend jamais ; le lot suivant redevinelaissez les champs de résultat et remplissez-les ; la Phase 1 lit les verdicts
Écrire le script complet/les timecodes iciempiète sur video-shorts ; brouille le registre des idéesarrêtez-vous à la ligne de crochet + son choisi ; transmettez
Capturer un signal de tendance sans datela fraîcheur n'est pas notable ; vous pourriez brief un son mortchaque signal porte une date de première vue ou il n'entre pas en Phase 3

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 vertical short is shot or scripted and you need the upload-form copy and cover that win the feed — the hook line, the first-frame on-screen text, the search-led caption, a tight hashtag set, and the cover frame; it learns from what performed via the 02-DOCS log. NOT inventing the idea (that is `shortform-ideation`), NOT scripting or directing the cuts (that is `video-shorts`), NOT executing the edit (that is `shortform-editing`), NOT scheduling the post (that is `social-publisher`).

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