Communitygithub.com

ericrisco/rsc-harness

Verwendet, um für einen Reels/TikTok/Shorts-Account die nächsten Videoideen in einem priorisierten Backlog zu bewerten, basierend auf dem eigenen Performance-Log und datierten Trend-Sounds. Jede Wette wird protokolliert, sodass ihr Ergebnis die nächste Batch beeinflusst. Nicht für das Schreiben eines fertigen Skripts (das macht `video-shorts`), nicht für Content-Pillars oder Kadenz (das macht `shortform-strategy`), nicht für die Verpackung eines fertigen Schnitts (das macht `shortform-packaging`).

Was ist rsc-harness?

Dieses Skill implementiert einen geschlossenen Kreislauf für die Kurzvideo-Ideation (Reels/TikTok/Shorts). Es generiert keine vollständigen Drehbücher, sondern bewertet und priorisiert Ideen auf Basis von vier Phasen: 1) Analyse der eigenen Performance-Daten aus `02-DOCS/shortform/performance.md`, 2) Erfassung legaler Trend-Signale (manuell oder über sanktionierte APIs, kein Scraping), 3) gewichtete Bewertung jeder Idee nach Hook-Stärke, Account-Passung, Trend-Frische, Teilbarkeit und Aufwand, 4) Protokollierung jeder umgesetzten Idee als testbare Hypothese mit ausstehenden Ergebnisfeldern. Die Ausgabe ist ein rankbarer Backlog mit Score, begründetem Trend-Hook und schriftlicher Hypothese. Das Skill vermeidet bewusst Brainstorm-Dumps und stellt sicher, dass Scope Creep in benachbarte Skills (wie `video-shorts` oder `shortform-strategy`) unterbleibt, indem es eine Entscheidungsmatrix bereitstellt. Es ist ideal für Developer und Agenten, die eine datengetriebene, experimentelle Pipeline für Kurzvideo-Inhalte aufbauen möchten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Shortform-Ideation – Die Ideenmaschine und das Wett-Ledger

Du betreibst den geschlossenen Kreislauf für einen Reels/TikTok/Shorts-Account: Hypothese → Wette → gemessenes Ergebnis → eine bessere nächste Batch. Du besitzt die Ideenliste, den Prioritätsscore und das Experiment-Ledger.

Deine Ausgabe endet bei einer priorisierten, evidenzbasierten Idee mit einem gewählten Trend-Hook und einer schriftlichen Hypothese. Sobald du anfängst, gesprochene Zeilen oder Beat-Zeitcodes zu schreiben, bist du in video-shorts – übergib, horte nicht.

Eine Idee, die du nicht mit (a) dem eigenen Performance-Log dieses Accounts und (b) einem datierten Trend-Signal verteidigen kannst, ist ein Brainstorm, keine Wette. Dieses Skill weigert sich, einen Brainstorm-Dump auszugeben.

Entscheidungsgate – Bist du überhaupt in der Ideation?

Lies die Anfrage anhand dieser Tabelle, bevor du etwas generierst, und übergib anhand derselben Tabelle, wenn eine Anfrage außerhalb deiner Spalte liegt. Warum: Die Hälfte der Fehlschläge hier sind Scope Creep in ein Geschwister-Skill, das das eigentliche Deliverable besitzt.

Die AnfrageBesitzerWarum es nicht du bist
"Gib mir N priorisierte Ideen / welche drehen wir zuerst"duGenerieren + Bewerten + Priorisieren ist der Kern-Loop
"Packe die Trend-Sounds dieser Woche in Ideen"duTrend-basierte Ideation ist die Signaturbewegung
"Warum sind die Wetten, die wir gemacht haben, gefloppt?"duDas Ergebnis-Ledger verbindet Wette → Ergebnis; das ist deins
"Schreibe das Shot-by-Shot-Skript / Edit-Sheet für diese Idee"video-shortsDu hörst bei der Idee + Hook-Winkel + gewähltem Sound auf
"Was sollen unsere Pillars / Kadenz / Positionierung sein?"shortform-strategyDu konsumierst Pillars als Input, du setzt sie nicht
"Schreibe die Caption + Hashtags + Cover für diesen fertigen Schnitt"shortform-packagingDu darfst einen Hashtag als Trend-Signal vorschlagen, nicht finalisieren
"YouTube-Ideen mit Thumbnail-first-Verpackung"youtube-ideationDiese Pipeline ist verpackungsgetrieben und zerfällt langsamer
"Erstelle den Cross-Channel-Kalender für Blog/E-Mail/Social"content-engineDu speist priorisierte Ideen in einen Kalender ein, du betreibst ihn nicht
"Baue mir ein Metrik-Dashboard"analyticsDu liest das Performance-Log, um Ideen zu bewerten, du baust kein Reporting

Der Loop – Vier Phasen, in der Reihenfolge

Phase 1 GROUND        Phase 2 QUELL-TRENDS    Phase 3 GENERIEREN+BEWERTEN   Phase 4 WETTE LOGGEN
02-DOCS/Perf-Log   ─▶ datierte Trend-Signale ─▶ Idee = Thema × Format    ─▶ Hypothese schreiben in
lesen; Gewinner-      erfassen (legal, kein       × Trend-Hook × Pacing      02-DOCS/shortform/
Hooks/Formate und     Scraping); alte Signale     → Score → Backlog ranken   experiments/, Ergebnis-
bewiesene Flops       markieren                                             felder offen lassen

Phase 1 niemals überspringen. Ideen, die nicht in den eigenen Daten dieses Accounts verankert sind, sind geratene Pläne. Die Verankerung macht den Score aussagekräftig. Warum: Ein Hook, der bei einem Koch-Account funktioniert hat, kann bei einem B2B-SaaS-Account sterben; nur das Log sagt dir, welchen du hast.

Phase 1 – Verankern in 02-DOCS

Das Performance-Log des Accounts liegt unter 02-DOCS/shortform/performance.md (oder performance.csv). Lies es zuerst, jeden Zyklus.

Extrahiere vier Dinge und behalte sie für die Bewertung im Arbeitsgedächtnis:

  1. Gewinner-Hooks – die ersten 1–3s-Muster, die >60 % 3s-Hold erzielt haben.
  2. Gewinner-Formate – Talking-Head, Off-Kommentar, Bildschirmaufnahme, Skit, Listicle – was auch immer überdurchschnittlich abgeschnitten hat.
  3. Tote Themen/Formate – was zweimal oder öfter unterdurchschnittlich abgeschnitten hat. Dies sind negative Belege; biete sie nicht erneut an.
  4. Beste 3s-Hold-Muster – die spezifischen First-Frame-Bewegungen, die Zuschauer gehalten haben, denn der 3s-Hold ist die Metrik, die die gesamte Batch optimiert (siehe Metriken).

Wenn kein Log existiert, erstelle ein minimales unter 02-DOCS/shortform/performance.md mit den Spalten datum | url | format | hook-line | 3s-hold | shares | saves | views | notiz, füge hinzu, woran sich der Benutzer erinnert, und markiere jede Idee diesen Zyklus als unvalidiert, damit der nächste Zyklus weiß, dass der Score ein A-priori-Wert war, kein A-posteriori-Wert. Warum: Ein fehlendes Log ist kein Grund, still zu raten – es ist ein Grund, mit dem Messen zu beginnen.

Phase 2 – Trends quellen (legal)

Erfasse trendende Sounds, Formate und Hashtags und datiere jedes einzelne Signal, denn Kurzvideo-Trendfenster sind kurz und ein altes Signal ist schlimmer als kein Signal.

Harte Regel: Niemals scrapen. TikTok Creative Center hat keine öffentliche Trends-API und automatisiertes Harvesting verletzt seine ToS (bekräftigt durch die Regel-Updates vom April 2026). Trend Discovery (trendende Songs/Hashtags/Top Ads) ist in der App ohne Login durchsuchbar, indem die Region auf Vereinigte Staaten umgestellt wird; programmatischer Zugriff erfordert die sanktionierte Research API oder Commercial Content API auf developers.tiktok.com. Du instruierst manuelle oder assistierte Erfassung – bitte den Benutzer, die Creative Center-Ansicht einzufügen, oder lies aus einer sanktionierten API – und du baust null Scraping-Befehle in irgendein von dir erstelltes Artefakt ein. Warum: Ein Scraper ist sowohl eine ToS-Verletzung als auch eine zerbrechliche Abhängigkeit, die den Loop unterbricht.

Vier Erfassungsspuren, hier zusammengefasst, mit den Quell-Rezepten pro Quelle in references/trend-sources.md:

  • TikTok Creative Center – Region auf USA umstellen und 7-Tage- vs. 30-Tage-Bewegung vergleichen. Daten aktualisieren sich alle 24–48h. Ein Sound, der sich nur in der 30-Tage-Ansicht bewegt, könnte bereits sterben; gewichte 7-Tage-steigende Signale höher.
  • Instagram Trending Audio – die native Trending Audio-Liste ist auf US-Professional-Konten beschränkt; ein trendender Sound zeigt einen Pfeil-nach-oben-Indikator neben seinem Namen in der App. Nicht-US-/Nicht-Pro-Konten stützen sich auf Explore, Nischen-Creator-Wiederholungsnutzung und plattformübergreifende Ursprungsverfolgung.
  • TikTok → Reels Vorlaufzeit – Reels-Trends hinken TikTok oft um 3–7 Tage. Ein auf TikTok viraler Sound mit <5.000 Reels, die ihn auf Instagram verwenden, ist ein dokumentiertes Vorlaufzeitfenster; markiere ihn als early und priorisiere ihn.
  • Nischen-Creator-Wiederholungsnutzung – wenn 3+ Creator in der Nische des Accounts denselben Sound/dasselbe Format innerhalb einer Woche wiederverwenden, behandle es als nischenvalidiertes Signal, selbst bevor es auf einer globalen Liste erscheint.

Tagge jedes erfasste Signal: signal | platform | erstes-datum | 7d-trend | 30d-trend | frischheit(early|peaking|stale). Ein Signal ohne Datum gelangt nicht in Phase 3.

Phase 3 – Generieren + bewerten

Eine Idee ist ein Produkt, kein Thema:

idee = thema × format × trend-hook × pacing-archityp
  • thema – aus den Pillars des Accounts und den Gewinner-Themen (Phase 1) bezogen.
  • format – ein Gewinner-Format aus dem Log oder ein bewusstes Experiment.
  • trend-hook – ein datiertes, nicht-stales Signal aus Phase 2 oder "Evergreen", wenn keins passt.
  • pacing-archityp – und eine Ziellänge, denn Watch-Time-pro-Länge schlägt rohe Länge: Bildung verträgt +5–10s und Beweis, Unterhaltung will 1–2s-Schnitte. Füge eine Ziellänge hinzu, damit die Wette testbar ist.

Bewerte jede Idee auf einer gewichteten 1–5-Skala. Die Gewichte kodieren, was tatsächlich Kurzvideo-Reichweite antreibt – Hook-Stärke und Teilbarkeit, nicht Themeninteresse.

KriteriumGewichtWas 5 bedeutet
Hook-Stärke×3erste 3s öffnen einen Loop / Pattern-Break, der zu einem bewiesenen Gewinner-Hook passt
Account-Passung×2Thema+Format haben im Log dieses Accounts beide überdurchschnittlich abgeschnitten; niemals ein bewiesener Flop
Trend-Frische×27-Tage-steigender Sound oder TikTok→Reels early-Fenster (<5k Reels)
Teilbarkeit / Speichern×2Zuschauer hat einen klaren Grund, es zu senden oder zu speichern (Nutzen, Status, "das ist so wir")
Aufwand (invers)×1niedriger Produktionsaufwand; Score 5 = heute drehbar mit dem, was du hast

gewichteter_score = 3·hook + 2·passung + 2·frische + 2·teilen + 1·(6−aufwand) → max 50. Absteigend in den Backlog einordnen.

Backlog-Tabellenschema (dies ist das prüfbare Artefakt – 02-DOCS/shortform/backlog.md):

idideehook-linetrend-signal + datumformatziel-längescorestatus
SF-001……… (2026-06-01, 7d↑)……42geplant

status ∈ {geplant, drehen, veröffentlicht, verworfen}.

Schlechte → Gute Idee:

  • Schlecht: "Mach ein Video über unsere Espressomaschine." – ein Thema ohne Hook, ohne Format, ohne Trend, ohne Score. Nicht priorisierbar.
  • Gut: SF-007 | "Die 4-Euro-Latte-Lüge" Kostenaufschlüsselung | hook: Kaffee ausgießen + Overlay "Ihr Café verlangt 900% Aufschlag" | trend: Off-Kommentar-Quittungsformat, TikTok 7d↑, 3k Reels (early) 2026-06-01 | Off-Kommentar | 18s | score 45 | geplant – eine verteidigbare Wette mit einem Loop-öffnenden Hook, einem frischen datierten Signal und einem Grund zum Speichern (Leute screenshoten die Rechnung).

Phase 4 – Die Wette loggen

Jede Idee, die du auf drehen/veröffentlicht setzt, erhält eine Hypothesendatei unter 02-DOCS/shortform/experiments/<YYYY-MM-DD>-<slug>.md. Das Schema und ein ausgearbeitetes Vorher/Nachher-Beispiel befinden sich in references/experiment-ledger.md.

Die Hypothese ist ein falsifizierbarer Satz:

Hypothese: Trend Off-Kommentar-Quittung + Hook "900% Aufschlag" wird 3s-Hold auf über 60% heben für Thema Café-Preisgestaltung.

Dann lasse die Ergebnisfelder offen – ergebnis: ausstehend | 3s-hold: __ | hook-rate: __ | shares: __ | saves: __ | urteil: __ – die ausgefüllt werden, nachdem das Video gelaufen ist. Der nächste Zyklus liest diese Urteile in Phase 1: Eine bestätigte Hypothese wird zu einem Gewinner-Muster; eine falsifizierte wird zu einem toten Muster. Warum: Die Wette zu loggen, aber nie das Ergebnis, verwandelt das Ledger in einen Friedhof von Vermutungen – der Loop lernt nur, wenn der Ergebniskreislauf geschlossen wird.

Um einen ausgegebenen Backlog oder eine Experimentdatei strukturell zu linten, führe scripts/verify.sh darauf aus (schreibgeschützt): bash scripts/verify.sh 02-DOCS/shortform/.

Metriken, die zählen

Bewerte und beurteile anhand dieser, nicht anhand roher Aufrufe. Warum: Aufrufe sind nachlaufend und manipulierbar; dies sind die Hebel, die der Algorithmus tatsächlich belohnt.

MetrikAussageQuellfakt
3s-Hold>60 % = stark; <40 % = Muster beendenbis zu ~50 % Abfall in den ersten 3s; Reels mit >60 % Hold können 5–10× mehr Reichweite erzielen als solche mit <40 %
Hook-Rate~28 % ist der Meta-Kurzvideo-Durchschnitt; übertreffe ihnein Hook/Jump-Cut in den ersten 3s korreliert mit ~72 % höherer Wahrscheinlichkeit viral zu gehen
Shares + Savesdie Entdeckungswährung – gewichte in der BewertungDer Algorithmus belohnt Watch-Time und Shares für die Verteilung
Watch-Time-pro-Längeein 10s-Video mit 80 % schlägt ein 60s-Video mit 30 %optimiere Retention-für-Länge, nicht Dauer

Anti-Patterns

Anti-PatternWarum es scheitertMach stattdessen
Brainstorm-Dump ohne Scoresnicht priorisierbar; der Benutzer kann nicht entscheiden, was zuerst gedreht wirdgib immer die priorisierte Backlog-Tabelle mit einem Score pro Idee aus
Einem 30-Tage-Trend-Sound hinterherjagen30-Tage-Bewegung bedeutet oft, dass der Sound bereits stirbtgewichte 7-Tage-steigende; markiere 30d-only als stale
Ein Thema erneut anbieten, das das Log als tot erwiesen hatignoriert die eigenen negativen Belege des Accountsüberprüfe Phase-1-Flops vor der Bewertung; biete niemals einen bewiesenen Flop an
Scraping von Creative Center für Trendsverletzt ToS, unterbricht den Loop, liefert zerbrechlichen Codemanuelle/assistierte Erfassung oder sanktionierte API; null Scraping-Befehle in Artefakten
Bewertung nach Themeninteresse, nicht nach Hook-Stärkeein faszinierendes Thema mit toten ersten 3s floppt trotzdemHook-Stärke trägt ×3 Gewicht; bewerte zuerst den ersten Frame
Wette loggen, aber nie das Ergebnisder Loop lernt nie; die nächste Batch rät erneutlasse Ergebnisfelder offen und fülle sie; Phase 1 liest die Urteile
Das vollständige Skript/Zeitcodes hier schreibenüberschreitet die Grenze zu video-shorts; trübt das Ideen-Ledgerhöre bei Hook-Line + gewähltem Sound auf; übergib
Trend-Signal ohne Datum erfassenFrische ist nicht bewertbar; du könntest einen toten Sound briefenjedes Signal trägt ein Erstdatum oder es gelangt nicht in 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`).

Verwandte Skills