Communitygithub.com

Screen Studio Demo Optimizer

Codex-Fähigkeit und Hilfsskripte zur sicheren Optimierung von Screen-Studio-Demo-Aufnahmen.

Was ist Screen Studio Demo Optimizer?

Der Screen Studio Demo Optimizer ist eine für Codex und ähnliche KI-Agenten optimierte Fähigkeit, die es ermöglicht, Screen-Studio-Projektaufnahmen sicher und reversibel zu bearbeiten. Sie ist ideal für Entwickler und Content-Ersteller, die Demos, Tutorials oder Investorenpräsentationen mit Screen Studio aufnehmen und anschließend KI-gestützt optimieren möchten. Die Fähigkeit unterstützt einen Workflow, der von der Klärung der Bearbeitungsabsicht über die Erstellung sicherer Arbeitskopien bis zur Analyse, Planung und Anwendung von Geschwindigkeits- und Zoom-Änderungen reicht. Wichtige Skripte wie `prepare_edit_copy.mjs`, `analyze_timeline.mjs`, `plan_compression.mjs`, `apply_speed_plan.mjs` und `optimize_zoom_track.mjs` automatisieren die einzelnen Schritte. Ein besonderer Fokus liegt auf der Sicherheit: Standardmäßig wird nur eine Kopie des Projekts bearbeitet, und alle Veränderungen müssen vor der Anwendung bestätigt werden. Die Fähigkeit arbeitet plattformunabhängig auf Dateiebene, kann aber optional auch Screen Studio im CDP-Modus direkt ansteuern, um eine Echtzeitvorschau und Validierung zu ermöglichen. Für den Agenten bietet das Skill eine klare, regelbasierte Entscheidungslogik, die zwischen verschiedenen Präsentationsstilen (Tutorial, Social Demo, Investor Demo) unterscheidet und dabei die Bildqualität und Logik der Aufnahme möglichst erhält.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add 77777R7/screenstudio-demo-optimizer

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Screen Studio Demo Optimizer?

Nutzen Sie diese Fähigkeit, um die Bearbeitungsabsicht eines Nutzers in sichere, reversible Änderungen an der Screen-Studio-Zeitleiste umzusetzen.

Die Fähigkeit ist kein festgelegter Bearbeitungsstil. Lassen Sie das gewünschte Ergebnis des Nutzers den Plan bestimmen: Zieldauer, Tempo, Logikerhalt, Geschwindigkeitsgrenzen, Zoomverhalten und Ausgabeformat.

Kernablauf

  1. Klären oder ermitteln Sie den Bearbeitungsvertrag:
    • Zieldauer: exakt, ungefähr oder uneingeschränkt.
    • Stil: Social-Demo, Tutorial, Investorendemo, interne Durchsprache, ruhiger Review, schneller Teaser oder benutzerdefiniert.
    • Priorität: jeden logischen Schritt erhalten, Wartezeiten kürzen, Wiederholungen löschen, Audio erhalten, Zooms erhalten, Bewegung reduzieren.
    • Ausgabe: nur Plan, Bearbeitungskopie oder Export.
  2. Erstellen Sie eine sichere Kopie, bevor Sie Änderungen vornehmen.
    • Verwenden Sie scripts/prepare_edit_copy.mjs.
    • Ändern Sie niemals das ursprüngliche .screenstudio-Projekt, es sei denn der Nutzer fordert es ausdrücklich.
  3. Analysieren Sie das Projekt.
    • Verwenden Sie scripts/analyze_timeline.mjs.
    • Lesen Sie Bereiche, Geschwindigkeiten, Wiedergabebereiche, Zoombereiche und Subsekunden-Zoomrisiken.
  4. Erstellen Sie einen bearbeitbaren Plan.
    • Verwenden Sie scripts/plan_compression.mjs, wenn eine Zieldauer angegeben wurde.
    • Erklären Sie den Plan in verständlichen Worten, bevor Sie ihn anwenden.
  5. Fragen Sie vor Mutationen an der Bearbeitungskopie um Bestätigung.
  6. Wenden Sie bestätigte Änderungen an.
    • Verwenden Sie scripts/apply_speed_plan.mjs.
    • Verwenden Sie scripts/normalize_project_json.mjs nach externen oder CLI-Speicherungen.
  7. Überprüfen Sie den Zoom-Komfort.
    • Verwenden Sie scripts/optimize_zoom_track.mjs --review.
    • Wenden Sie Zoomänderungen nur nach Bestätigung an.
  8. Verifizieren Sie.
    • Verwenden Sie scripts/verify_project.mjs.
    • Optional: Verwenden Sie scripts/screenstudio_cdp_open_project.mjs und screenstudio --port <port> status, falls Screen Studio verfügbar ist.

Präferenzvertrag

Wenn der Nutzer ausreichend Absicht geäußert hat, fahren Sie mit angemessenen Standardwerten fort. Ist das Ziel unklar, stellen Sie eine präzise Frage.

Standardvertrag, wenn der Nutzer nur „Mach es besser“ sagt:

{
  "targetSeconds": null,
  "style": "balanced-demo",
  "preserveLogic": true,
  "allowDelete": false,
  "maxReadingSpeed": 1.6,
  "maxActionSpeed": 3,
  "maxWaitSpeed": 10,
  "zoomPolicy": "reduce-jumpy-zooms"
}

Übliche Voreinstellungen:

  • social-demo: kurz, prägnant, hohe Wartezeitgeschwindigkeit, ruckelige Zooms reduzieren.
  • tutorial: langsamer, Schritte erhalten, aggressive Zoomänderungen vermeiden.
  • investor-demo: knapp, erzählerische Momente erhalten, Ergebnisse betonen.
  • agent-workflow: Warte-/Ladezeiten stark beschleunigen, wichtige Entscheidungen und das Endergebnis erhalten.
  • review-only: analysieren und empfehlen, nichts ändern.

Lesen Sie references/compression-rules.md für Tempo-Heuristiken und references/zoom-comfort-rules.md, bevor Sie Zooms bearbeiten.

Skript-Kurzanleitung

Sichere Dateien vorbereiten:

node scripts/prepare_edit_copy.mjs "/pfad/zum/demo.screenstudio"

Analysieren:

node scripts/analyze_timeline.mjs "/pfad/zum/demo.agent-edit-copy.screenstudio"

Einen 90-Sekunden-Schnitt planen:

node scripts/plan_compression.mjs "/pfad/zum/demo.agent-edit-copy.screenstudio" --target-seconds 90 --preset social-demo > /tmp/plan.json

Bestätigten Plan anwenden:

node scripts/apply_speed_plan.mjs "/pfad/zum/demo.agent-edit-copy.screenstudio" /tmp/plan.json
node scripts/verify_project.mjs "/pfad/zum/demo.agent-edit-copy.screenstudio"

Zoom-Komfort überprüfen:

node scripts/optimize_zoom_track.mjs "/pfad/zum/demo.agent-edit-copy.screenstudio" --review

In Screen Studio im CDP-Modus öffnen (wenn Screen Studio installiert ist):

node scripts/screenstudio_cdp_open_project.mjs "/pfad/zum/demo.agent-edit-copy.screenstudio"

Sicherheitsregeln

  • Standardmäßig bei nicht-trivialen Bearbeitungen immer zuerst einen Plan erstellen.
  • Das ursprüngliche Projekt nicht überschreiben (Standardeinstellung).
  • Keine Bereiche löschen, es sei denn, der Nutzer hat das Löschen erlaubt.
  • Audio-lastige oder sprachgeführte Aufnahmen als geschwindigkeitsempfindlich behandeln.
  • project.json nach dem Speichern normalisieren, da Screen-Studio/CLI-Workflows Projektdaten als verschachtelte JSON-Strings speichern können.
  • Endgültige Dauer aus der Projektdatei und, wenn möglich, aus der Screen-Studio-Laufzeitumgebung überprüfen.
  • Exakt geänderte Bereiche und Zooms melden.

Lesen Sie references/safety-and-backups.md, bevor Sie destruktive oder irreversible Aktionen durchführen.

Bekannte Einschränkungen

  • Screen-Studio-Interna können sich zwischen Versionen ändern. Schlägt das Öffnen über CDP fehl, analysieren Sie die Projektdatei und informieren Sie den Nutzer.
  • Die visuelle Qualität kann allein aus den Zeitliniendaten nicht vollständig beurteilt werden. Verwenden Sie bei Verfügbarkeit die Frame-Extraktion oder die Screen-Studio-Vorschau.
  • Die mitgelieferten Skripte sind konservative Bausteine. Der Agent sollte dennoch subjektive Kompromisse erklären und um Bestätigung bitten.

Verwandte Skills