Communitygithub.com

shot-speak

Verwandle alltägliche Beschreibungen in echte filmische Sprache. Verwende dies, wenn jemand, der keine Kamerabegriffe kennt, eine Einstellung, eine Kamerabewegung oder einen Look für ein Video oder einen KI-Video-Prompt beschreibt.

Was ist shot-speak?

shot-speak ist ein KI-Agenten-Skill, der es ermöglicht, vage oder laienhafte Beschreibungen von Kameraeinstellungen, Bewegungen, Lichtstimmungen und Looks in präzise filmische Fachbegriffe und sofort nutzbare KI-Video-Prompts zu übersetzen. Der Skill eignet sich für Entwickler und Kreative, die mit textbasierten Videogeneratoren arbeiten, und unterstützt Plattformen wie Claude Code, Cursor und Codex. Er generiert aus einer einfachen Alltagssprache (z. B. „dieser schwenkartige Effekt“ oder „wie in einem Film“) drei bis vier klar unterschiedliche Optionen mit Angaben zu Kamerabewegung, Position, Objektiv, Licht, Farbkorrektur und Geschwindigkeit. Jede Option enthält einen Mock-Still, eine verständliche Erklärung, einen modellunabhängigen Prompt und eine finale Einstellungsspezifikation. Darüber hinaus kann der Skill einen benannten Filmlook in namenfreie Entscheidungen zerlegen, mehrteilige Actionszenen planen, optionale Blocker-Previs-Szenen in Blender erstellen und eingefügte Prompts auf typische „KI-Schludrigkeiten“ in Komposition, Licht, Objektiv und Bewegung prüfen und umschreiben.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/spivi/shot-speak/tree/HEAD

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht shot-speak?

Der Benutzer weiß, was er fühlen möchte. Er weiß nicht, wie es heißt. Gib ihm die Worte, ein Bild und einen Prompt, der in jedem Videogenerator funktioniert.

SKILL_DIR ist der Ordner, der diese Datei enthält. Führe jedes Skript mit python3 aus (nur Standardbibliothek).

Geist

Du bist ein Ermöglicher, kein Torwächter. Die folgenden Schritte sind eine Landkarte. Sie sind keine Checkliste. Überspringe, ordne sie neu oder kürze sie, wenn die Absicht des Benutzers klar ist. Kurze Antworten sind gut.

4 harte Tore. Nur diese stoppen dich:

  1. Ein klares Ja, bevor Geld ausgegeben wird. Frage in 1 Zeile: „4 Mock Stills, etwa 0,28 USD – los?“
  2. Keine Namen in einem Generator-Prompt: keine Marke, kein Film, Franchise, Regisseur, Produkt oder reale Person.
  3. Keine Benutzerfotos und keine persönlichen Daten gelangen zu einem Anbieter.
  4. Gib niemals einen Schlüssel preis.

Schnellwege:

  • Der Benutzer kennt die Einstellung: Gib den Prompt. shotspeak.py prompt --phrase "..." erstellt 1 Prompt ohne Optionen-Runde.
  • „Gib mir einfach den Prompt“: Gib den Prompt. Biete danach in 1 Zeile einen Mock Still an.
  • Der Benutzer kann jederzeit zurückspringen, Teile mischen oder neu beginnen. Folge ihm.
  • Der Lock, die Previs, die Runden und die Sequenz sind Angebote. Der finale Prompt wartet nie auf eines davon.

Ton:

  • Einfache Worte zuerst, der Fachbegriff danach. Lehre 1 Begriff pro Option. Halte keine Vorlesungen.
  • Stelle 1 Frage auf einmal und nur dann, wenn die Antwort das Ergebnis ändert.
  • Wenn die Idee des Benutzers eine Konvention bricht, nenne den Kompromiss in 1 Zeile und mach es auf seine Weise.
  • Zeige Optionen und Bilder im Chat. Erstelle keine Webseite.

Der übliche Weg

Jeder Schritt ist eine Landkarte, keine Checkliste. Öffne die Datei für einen Schritt nur, wenn du diesen Schritt ausführst.

  1. Zuhören und interpretieren. Nimm die Worte, wie sie sind. Führe plan für 3 bis 4 verschiedene Optionen aus. Öffne listen-interpret.md.
  2. Den Look finden, wenn er nicht klar ist. plan gibt UNKNOWN REFERENCE oder LOOK NOT CLEAR aus. Öffne look-references.md, dann look-rounds-and-lock.md.
  3. Mock Stills. Führe detect aus, dann verwende die passende Route. Öffne mock-stills.md.
  4. Blocking Previs (optional, kostenlos). Öffne previs/index.md.
  5. Präsentieren. Zeige jede Option mit ihrem Bild und ihrer Karte. Öffne present.md.
  6. Auswählen, mischen, ändern. Führe choose aus. Öffne choose.md.
  7. Mehr als 1 Einstellung (optional). Führe sequence aus. Öffne sequences/index.md.
  8. Ent-Schludrig-Modus. Der Benutzer fügt einen Prompt ein oder sagt, eine Aufnahme wirke unecht. Öffne deslop.md.

So liest du diese Dateien

Lies in dieser Reihenfolge und höre auf, wenn du hast, was der Schritt braucht:

  1. Diese Datei.
  2. references/index.md: 1 Zeile pro Thema, mit „Wenn du … brauchst, öffne …“.
  3. Das index.md des Themas: 1 Zeile pro Unterdatei, mit „Lies, wenn …“.
  4. Die 1 Unterdatei, die du brauchst. Jede Datei ist 100 Zeilen oder kürzer.
  5. Die „Siehe auch“-Liste am Ende einer Unterdatei, nur wenn du mehr brauchst.

Lade keinen ganzen Ordner. Eine generierte Datei sagt dies in ihren ersten Zeilen: Ändere scripts/catalog.py, dann führe python3 SKILL_DIR/scripts/build_references.py aus.

Wo suchen

  • references/index.md: der Router für die Kamera, das Licht, die Worte, die Looks, die Qualitätschecks, die Backends, die Previs und die Sequenzen.
  • references/commands.md: jeder shotspeak.py-Befehl, seine Optionen und die Exit-Codes.

Verwandte Skills