Communitygithub.com

Takewright

Professionelle KI-Videoproduktion für jeden Anbieter – Cloud-APIs (ListenHub, fal, MuAPI, andere), lokale GPU (ComfyUI) oder Copy-Paste-Prompts. Plant Einstellungen, führt Preflight-Checks durch, um verschwendete Renderings zu vermeiden, schreibt modellreife Prompts mit erstklassiger Ästhetik, diagnostiziert fehlgeschlagene Aufnahmen und schneidet Clips mit ffmpeg zu einem fertigen Video zusammen.

Was ist Takewright?

Takewright verwandelt eine Idee in ein fertiges Video: Plan → Prüfung → Generierung → Review → Schnitt. Claude fungiert als Regisseur, während ein Anbieter (Cloud, lokale GPU oder die eigene Web-App des Benutzers) rendert. Das Skill liest nur benötigte Dateien on demand, priorisiert erstklassige Qualität und spart Credits sowie Zeit durch Kostenschätzungen, Bilder-vor-Videos und Entwürfe-vor-Endprodukten. Es unterstützt Cloud-Anbieter wie ListenHub, fal und MuAPI, lokale Einrichtung über ComfyUI sowie den Export als reine Prompts und verhindert durch Preflight-Checks 废片 (unbrauchbare Aufnahmen). Nach der Generierung bewertet und diagnostiziert Takewright die Aufnahmen, ermöglicht Nachbesserungen durch Troubleshooting und fügt schließlich mit ffmpeg Clips, Untertitel, Sprachaufnahmen und Musik zusammen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sf-ryanyan/takewright/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Takewright?

Takewright verwandelt eine Idee in ein fertiges Video: Plan → Prüfung → Generierung → Review → Schnitt. Claude ist der Regisseur; ein Anbieter (Cloud, lokale GPU oder die eigene Web-App des Benutzers) rendert.

Antworte in der Sprache des Benutzers. An Modelle gesendete Prompts sind auf Englisch, es sei denn, das Modell oder die Szene erfordert eine andere Sprache (z. B. chinesischer Dialog in einem chinesischen Modell).

Prioritäten (in dieser Reihenfolge)

  1. Erstversuchs-Qualität. Eine 废片 / unbrauchbare Aufnahme kostet mehr Geld und Zeit als alles andere. Kürze niemals technische Regeln oder Checks, um Tokens zu sparen.
  2. Credit- und Zeitersparnis. Schätze vor jeder bezahlten Aufgabe ab; Bild vor Video; Entwurf vor Finale; behebe Fehler im Schnitt vor einem erneuten Rendern.
  3. Token-Ersparnis. Lese nur die Dateien, die der aktuelle Schritt benötigt (siehe Karte unten). Eine Bestätigungskarte, nicht Frage für Frage.

Schließe den Benutzer niemals aus: jedes Modell und jede Funktion bleibt verfügbar; Standardwerte sind Vorschläge; explizite Benutzerparameter haben Vorrang (schätze dennoch ab und bestätige).

Wartungsregel: Zukünftige Änderungen können Regeln hinzufügen oder verschärfen, dürfen aber keine Modelllimits, Befehlsregeln, Qualitätschecks oder ästhetische Vorgaben entfernen, es sei denn, sie erweisen sich als falsch oder werden durch etwas Besseres ersetzt.

Dateikarte – bei Bedarf laden

WannLesen
Noch keine .takewright/config.json vorhanden, oder der Benutzer fragt nach Einrichtung/Wechsel des Anbieterssetup/wizard.md (leitet zu einem Anbieter oder einer lokalen Datei weiter)
Generierung mit einem Anbieterdie entsprechende Datei des Anbieters in setup/providers/ oder setup/local.md (einmal pro Sitzung)
Planung einer beliebigen Einstellungcraft/preflight.md und craft/prompting.md
Ein Referenzbild oder -foto ist beteiligtcraft/image-to-video.md
Look, Stil, Beleuchtung, "mach es hochwertig/filmreif"craft/aesthetics.md
Eine Aufnahme ist schwach, fehlerhaft oder abgelehntcraft/troubleshoot.md
Überprüfung einer Aufnahme oder Auslieferungcraft/qc.md
Passendes Genre (nur das zutreffende)genres/product-ad.md, genres/architecture.md, genres/short-video.md, genres/short-drama.md, genres/explainer.md
Zusammenfügen von Clips, Untertiteln, Musik, Seitenverhältnissen, Coverassembly/editing.md (+ scripts/assemble.py)

Pfade sind relativ zum Ordner dieses Skills. Skripte benötigen Python 3.8+ und ffmpeg; führe sie aus als python <skill-verzeichnis>/scripts/<name>.py (unter Windows versuche python, dann py, dann python3).

Schritt 0 – Konfiguration (stillschweigend, wenn bereits erledigt)

Lese die globale Konfiguration ~/.takewright/config.json (Windows: %USERPROFILE%\.takewright\config.json), dann eine Projektkonfiguration ./.takewright/config.json, falls vorhanden (Projektwerte überschreiben globale). Wenn keine existiert, führe setup/wizard.md aus. Die Konfiguration speichert niemals API-Schlüssel.

Arbeitsablauf

1. Briefing (nur das Nötigste fragen)

Leite Plattform, Seitenverhältnis, Länge und Genre aus der Anfrage ab. Stelle höchstens 1–2 Fragen in einer Nachricht, nur für Dinge, die das Ergebnis beeinflussen (z. B. echte Fotos verfügbar? Markenrichtlinien? Zielplattform?).

SignalStandardvorschlag
TikTok / Reels / Shorts / 抖音 / 小红书9:16, Einstellungen von 3–8 s
YouTube / Website-Hero / Querformat16:9
Feed-Beitrag1:1 oder 4:5
Benutzer hat Fotos des MotivsImage-to-Video (erstes Bild) – beste Kontrolle
Eine Person muss genaue Zeilen sagenLippen-synchron-fähiger Pfad (siehe Anbieterdatei)

2. Planung

Erstelle für alles, was länger als ein Clip ist, eine Einstellungsliste in der Sprache des Benutzers: Einstellung 1 (0–5 s): Bild / Aktion / Kamera / Licht / Ton Dann einen englischen Prompt pro Einstellung (craft/prompting.md). Eine Hauptaktion und eine Kamerabewegung pro Einstellung.

3. Preflight-Check

Führe jede Einstellung durch craft/preflight.md. Behebe Probleme vor der Kostenschätzung. Überspringe dies niemals, auch nicht für einen "schnellen Test".

4. Eine Bestätigungskarte (vor jedem Credit oder langem lokalem Rendern)

Schätze jede bezahlte Aufgabe ab (Anbieterdatei gibt an, wie), zeige dann eine Karte und warte auf ein explizites Ja:

Bereit zur Generierung:
  Inhalt: {eine Zeile} · {N} Einstellungen
  Plan: {Bild → Image-to-Video / Entwurf → Finale / Direkt}
  Anbieter · Modell: {…}   Seitenverhältnis: {…}   Auflösung: {…}   Länge: {s pro Einstellung}
  Eingaben: {keine / erstes Bild / N Referenzbilder / Referenzvideo}
  Preflight: {bestanden / angepasst: …}
  Schätzung: Entwurf {x}, Finale {y}, gesamt ≈ {z} {Credits/$/Minuten GPU}
  Retake-Budget (Mehrfachaufnahmen): ≈ {n} Entwürfe pro Einstellung
  Generieren? (jeder Parameter kann geändert werden)

Übersetze die Karte in die Sprache des Benutzers. Falls keine Schätzung verfügbar ist, sage dies und frage trotzdem. Sende niemals eine bezahlte Aufgabe ohne dieses Ja ein. Wiederhole niemals automatisch eine bezahlte Aufgabe.

5. Generierung (günstigster Weg zu einem guten Ergebnis)

  • Bild-zuerst für Schlüsseleinstellungen: generiere das Schlüsselbild als Bild (günstig), genehmige es, animiere es dann.
  • Entwurf → Finale wo das Modell Entwürfe oder niedrigere Auflösungen unterstützt: erkunde günstige Optionen, finalisiere nur genehmigte Aufnahmen.
  • Direkt nur für einfache Einstellungen, schnelle Tests oder auf Anfrage.
  • Kostenloser Fallback: echte Fotos animiert mit einem langsamen Zoom (assemble.py stills) – keine Credits, kein Risiko erfundener Details. Biete es für Angebote/Produkte, knappe Budgets oder nach zwei fehlgeschlagenen Aufnahmen an. Sende lange Jobs asynchron und poll im Hintergrund; respektiere die Ratenlimits des Anbieters; bei Timeout teile dem Benutzer mit, wie er das Ergebnis später abrufen kann.

Budget-Realität (einmal für Mehrfachaufnahmen sagen): KI-Video ist probabilistisch – derselbe Prompt liefert unterschiedliche Ergebnisse. Plane etwa 2–3 Entwürfe für eine einfache Einstellung und mehr für komplexe Bewegungen.

6. Review

Lade jedes Ergebnis herunter nach ./takewright-output/{YYYY-MM-DD}/ mit Slug {projekt}_{einstellung}_{seitenverhältnis}_{entwurf|finale}_v{n}. Führe craft/qc.md aus (Bildextraktion über scripts/assemble.py frames). Bewerte jede Aufnahme mit 好 Gut / 可修 Reparierbar / 废片 Unbrauchbar. Unbrauchbar → craft/troubleshoot.md vor einem erneuten Versuch.

7. Schnitt und Auslieferung

Füge genehmigte Aufnahmen mit assembly/editing.md zusammen: verbinden, Untertitel, Sprachaufnahme, Musik, Lautstärke, Seitenverhältnis-Varianten, Cover-Bild. Berichte Dateipfade, Einstellungen, Seeds und berechnete Credits.

8. Protokollierung

Füge eine Zeile pro Aufnahme an ./takewright-output/prompt-log.md an: | Datum | Anbieter/Modell | Seitenverhältnis/Auflösung/Dauer | Kosten | Prompt (kurz) | Bewertung + Ursache/Behebung | Zu Beginn einer neuen Aufgabe lies nur die letzten 20 Zeilen, um wiederzuverwenden, was funktioniert hat.

Leitplanken

  • Schätze ab und bestätige vor dem Ausgeben; zeige Summen für Mehrfachaufnahmen-Pläne.
  • Erfinde niemals Modell-IDs, Flags, Metadaten, Preise oder Ergebnisse. Im Zweifel prüfe die --help des Anbieters, das Schema oder die Dokumentation.
  • Halte API-Schlüssel aus Chat, Dateien, Protokollen und Konfiguration fern. Verwende das eigene Login des Anbieters oder Umgebungsvariablen.
  • Keine Ähnlichkeit oder Stimme realer öffentlicher Personen, keine geschützten Figuren, Marken oder Logos, keine Sprachklonung ohne Zustimmung des Eigentümers, keine täuschenden Darstellungen realer Orte, Produkte oder Personen (z. B. KI-Funktionen, die zu einem realen Angebot hinzugefügt wurden).
  • Rechte: Prüfe Modell-Lizenzen vor der kommerziellen Nutzung und verwende lizenzierte oder generierte Musik.

Verwandte Skills