DrErwin/videoscript-skill

VideoScript-Transkripte

Was diese Fähigkeit tut

Sie steuert das Kommandozeilen-Client-Programm videoscript. Die CLI kommuniziert mit der öffentlichen VideoScript-API mit einem Schlüssel, den der Benutzer für sich selbst ausgestellt hat; der Dienst führt die Extraktion, Transkription und Abrechnung durch. Diese Fähigkeit spricht niemals selbst HTTP und handhabt niemals einen Schlüssel.

Vor allem anderen

videoscript auth status --json

• {"authenticated": true, ...} → weitermachen.
• Exit-Code 3 → der Benutzer ist nicht angemeldet. Fordern Sie ihn auf, einen API-Schlüssel auf der VideoScript-Website zu erstellen und videoscript auth login --token <key> selbst auszuführen. Bitten Sie ihn niemals, den Schlüssel in die Konversation einzufügen, und geben Sie ihn niemals wieder.
• videoscript nicht gefunden → bitten Sie den Benutzer, es zu installieren (npm install -g videoscript).

Der normale Ablauf

# 1. Einreichen (gibt sofort eine Aufgaben-ID zurück)
videoscript transcribe create "<url>" --json

# 2. Darauf warten (beachtet den Retry-After des Servers)
videoscript transcribe wait <id> --json

# 3. Transkript in eine Datei schreiben, nicht in den Chat
videoscript transcript get <id> --format markdown --output notes/<name>.md

Wichtige Regeln:

• Eine Einreichung = ein Idempotenzschlüssel. Die CLI generiert ihn und gibt ihn in --json aus; wenn ein Aufruf wiederholt werden muss, verwenden Sie diesen Schlüssel erneut (--idempotency-key), damit der Benutzer nie doppelt bezahlt.
• Lange Transkripte gehen in Dateien. Lesen Sie die Datei nur so weit, wie es die Anfrage des Benutzers erfordert. Fügen Sie niemals ein ganzes stundenlanges Transkript in die Konversation ein.
• Verbrauch ist sichtbar. Jede abgeschlossene Aufgabe verbraucht die Credits des Benutzers und erscheint in seiner Bibliothek; sagen Sie dies vor dem Einreichen einer langen Aufgabe.
• Inhaltslimits liegen beim Dienst, nicht bei Ihnen, um sie zu umgehen. Anmeldungen, kostenpflichtige Inhalte, DRM, Regionssperren und Live-Streams werden bewusst abgelehnt. Schlagen Sie keine Proxys, Cookies oder Downloader von Drittanbietern vor.

Wenn etwas schief geht

Exit-Codes: 3 Anmeldung, 4 keine solche Aufgabe, 5 später wiederholen, 6 Credits/Budget, 7 die Quelle wird abgelehnt.

• 5 → warten Sie auf das Retry-After, das die CLI meldet, und wiederholen Sie den Vorgang. Die CLI wiederholt bereits zweimal von selbst.
• 6 → teilen Sie dem Benutzer mit, dass sein Guthaben oder das Budget dieses Schlüssels erschöpft ist; versuchen Sie niemals einen Kauf.
• 7 → erklären Sie die Einschränkung klar und beenden Sie den Vorgang. Nicht wiederholen.
• 1/2 → unerwarteter Fehler oder falsche Argumente; lesen Sie die Meldung, korrigieren Sie den Aufruf.

Vollständige Tabellen: reference/cli.md und reference/errors.md.

Was diese Fähigkeit nicht tut

Uploads, Bulk-Jobs, Löschen von Aufgaben, Zahlungen, Admin-Aktionen oder alles, was das Passwort des Benutzers benötigt. Die Berechtigungen des Schlüssels werden vom Service durchgesetzt.