Communitygithub.com

ComeOnOliver/skillshub

Erstellt oder verwaltet kurze Videoclips für das aktuelle Projekt (Produkt-Demos, Marketing-Spots, filmische Aufnahmen, UI-Mockups). Standardmäßig wird `sora-2` und ein strukturierter Prompt-Erweiterungs-Workflow verwendet, bevorzugt wird das gebündelte CLI für deterministische Ausführungen. Hinweis: `$sora` ist ein Skill-Tag in Prompts, kein Shell-Befehl.

Was ist skillshub?

Dieser Skill ermöglicht es KI-Agenten, kurze Videoclips direkt aus dem Projektkontext heraus zu generieren und zu verwalten. Er eignet sich für Produkt-Demos, Marketing-Spots, filmische Aufnahmen und UI-Mockups und verwendet standardmäßig das Modell `sora-2` sowie einen strukturierten Prompt-Erweiterungs-Workflow. Der Skill unterstützt das Erstellen neuer Clips, das Remixen bestehender Videos anhand einer ID, das Abfragen des Status von asynchronen Jobs, das Herunterladen von Assets (Video/Thumbnail/Spritesheet) und die Stapelverarbeitung mehrerer Prompts. Er nutzt die OpenAI Python SDK und die gebündelte CLI (`scripts/sora.py`), wobei die Authentifizierung über die Umgebungsvariable `OPENAI_API_KEY` erfolgt. Der Skill enthält detaillierte Entscheidungsbäume, Prompt-Erweiterungsvorlagen, Best Practices zur Vermeidung von Artefakten und eine umfassende Referenzdokumentation, die in separaten Dateien wie `references/cli.md` und `references/video-api.md` strukturiert ist.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/openai/skills/sora

In Ihrer bevorzugten KI fragen

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

Dokumentation

Sora Video-Generierungs-Skill

Erstellt oder verwaltet kurze Videoclips für das aktuelle Projekt (Produkt-Demos, Marketing-Spots, filmische Aufnahmen, UI-Mockups). Standardmäßig wird sora-2 und ein strukturierter Prompt-Erweiterungs-Workflow verwendet, bevorzugt wird das gebündelte CLI für deterministische Ausführungen. Hinweis: $sora ist ein Skill-Tag in Prompts, kein Shell-Befehl.

Verwendungszwecke

  • Erstellen eines neuen Videoclips aus einem Prompt
  • Remixen eines bestehenden Videos anhand seiner ID
  • Statusabfrage, Auflisten von Jobs oder Herunterladen von Assets (Video/Thumbnail/Spritesheet)
  • Stapelverarbeitung (mehrere Prompts oder Varianten)

Entscheidungsbaum (Erstellen vs. Remixen vs. Status/Download vs. Stapel)

  • Wenn der Benutzer eine Video-ID hat und eine Änderung wünscht → remixen
  • Wenn der Benutzer eine Video-ID hat und den Status oder Assets möchte → Status/Abrufen/Herunterladen
  • Wenn der Benutzer viele Prompts/Assets benötigt → Stapel erstellen
  • Wenn der Benutzer nach zwei Versionen mit einer kleinen Änderung fragt (gleiche Einstellung, anderes Motiv/Detail) → Erstellen des Basismaterials, dann Remixen für die Variation
  • Andernfalls → Erstellen (oder Erstellen und Abfragen, wenn sie ein fertiges Asset in einem Schritt benötigen)

Arbeitsablauf

  1. Absicht bestimmen: Erstellen vs. Remixen vs. Status/Download vs. Stapel.
  2. Eingaben sammeln: Prompt, Modell, Größe, Sekunden und ggf. ein Referenzbild.
  3. Bei Stapel: eine temporäre JSONL-Datei unter tmp/ schreiben (ein Job pro Zeile), einmal ausführen, dann die JSONL-Datei löschen.
  4. CLI-Erweiterungsflags (--use-case, --scene, --camera usw.) bevorzugen, anstatt einen strukturierten Prompt vorzuschreiben. Wenn Sie bereits eine strukturierte Prompt-Datei erstellt haben, übergeben Sie --no-augment, um eine doppelte Umhüllung zu vermeiden.
  5. Das gebündelte CLI (scripts/sora.py) mit sinnvollen Standardwerten ausführen (siehe references/cli.md). Bei langen Prompts --prompt-file bevorzugen, um Probleme mit Shell-Escaping zu vermeiden; mit --no-augment kombinieren, wenn der Prompt bereits strukturiert ist.
  6. Bei asynchronen Jobs den Status abfragen, bis sie abgeschlossen sind (oder create-and-poll verwenden).
  7. Assets (Video/Thumbnail/Spritesheet) herunterladen und lokal speichern.
  8. Zwischendateien, die während des Aufrufs erstellt wurden (z. B. prompt.txt, remix_job.json, temporäre JSONL), entfernen. Falls die Sandbox rm blockiert, Bereinigung überspringen oder Dateien ohne Fehlermeldung kürzen.
  9. Mit einer einzelnen gezielten Änderung pro Prompt iterieren.

Authentifizierung

  • OPENAI_API_KEY muss für Live-API-Aufrufe gesetzt sein.

Wenn der Schlüssel fehlt, geben Sie dem Benutzer diese Schritte:

  1. Erstellen Sie einen API-Schlüssel in der OpenAI-Plattform-UI: https://platform.openai.com/api-keys
  2. Setzen Sie OPENAI_API_KEY als Umgebungsvariable in seinem System.
  3. Bieten Sie an, ihn bei der Einrichtung der Umgebungsvariable für sein Betriebssystem/Shell zu unterstützen.
  • Bitten Sie den Benutzer niemals, den vollständigen Schlüssel im Chat einzufügen. Bitten Sie ihn, ihn lokal zu setzen und zu bestätigen, wenn er bereit ist.

Standardwerte & Regeln

  • Standardmodell: sora-2 (verwenden Sie sora-2-pro für höhere Wiedergabetreue).
  • Standardgröße: 1280x720.
  • Standardsekunden: 4 (erlaubt: "4", "8", "12" als Zeichenketten).
  • Größe und Sekunden stets über API-Parameter setzen; Textangaben ändern sie nicht.
  • Verwenden Sie das OpenAI Python SDK (openai-Paket); kein rohes HTTP.
  • OPENAI_API_KEY vor jedem Live-API-Aufruf erforderlich.
  • Wenn uv-Cache-Berechtigungen fehlschlagen, setzen Sie UV_CACHE_DIR=/tmp/uv-cache.
  • Eingangsreferenzbilder müssen jpg/png/webp sein und sollten der Zielgröße entsprechen.
  • Download-URLs laufen nach etwa 1 Stunde ab; kopieren Sie Assets in Ihren eigenen Speicher.
  • Bevorzugen Sie das gebündelte CLI und ändern Sie niemals scripts/sora.py, es sei denn, der Benutzer verlangt es.
  • Sora kann Audio generieren; wenn ein Benutzer Voiceover/Audio wünscht, geben Sie es explizit in den Zeilen Audio: und Dialogue: an und halten Sie es kurz.

API-Einschränkungen

  • Modelle sind auf sora-2 und sora-2-pro beschränkt.
  • Der API-Zugriff auf Sora-Modelle erfordert ein organisations-verifiziertes Konto.
  • Die Dauer ist auf 4/8/12 Sekunden begrenzt und muss über den Parameter seconds gesetzt werden.
  • Die API erwartet seconds als String-Enumeration ("4", "8", "12").
  • Ausgabegrößen sind modellabhängig (siehe references/video-api.md für unterstützte Größen).
  • Die Videoerstellung ist asynchron; Sie müssen den Abschluss abfragen, bevor Sie herunterladen.
  • Rate-Limits gelten nach Nutzungsstufe (keine spezifischen Grenzen auflisten).
  • Inhaltseinschränkungen werden von der API durchgesetzt (siehe Schutzmaßnahmen unten).

Schutzmaßnahmen (müssen durchgesetzt werden)

  • Nur Inhalte, die für Minderjährige unter 18 Jahren geeignet sind.
  • Keine urheberrechtlich geschützten Charaktere oder urheberrechtlich geschützte Musik.
  • Keine echten Personen (einschließlich öffentlicher Persönlichkeiten).
  • Eingabebilder mit menschlichen Gesichtern werden abgelehnt.

Prompt-Erweiterung

Formatieren Sie Prompts in eine strukturierte, produktionsorientierte Spezifikation um. Machen Sie nur implizite Details explizit; erfinden Sie keine neuen kreativen Anforderungen.

Vorlage (nur relevante Zeilen einfügen):

Use case: <wo der Clip verwendet wird>
Primary request: <Hauptprompt des Benutzers>
Scene/background: <Ort, Tageszeit, Atmosphäre>
Subject: <Hauptmotiv>
Action: <einzelne klare Aktion>
Camera: <Einstellungsart, Winkel, Bewegung>
Lighting/mood: <Beleuchtung + Stimmung>
Color palette: <3-5 Farbanker>
Style/format: <Film/Animation/Format-Hinweise>
Timing/beats: <Zählungen oder Beats>
Audio: <Atmosphäre / Musik / Voiceover, falls angefordert>
Text (verbatim): "<exakter Text>"
Dialogue:
<Dialog>
- Sprecher: "Kurze Zeile."
</Dialog>
Constraints: <muss behalten / muss vermeiden>
Avoid: <negative Einschränkungen>

Erweiterungsregeln:

  • Halten Sie es kurz; fügen Sie nur Details hinzu, die der Benutzer bereits impliziert oder an anderer Stelle angegeben hat.
  • Listen Sie bei Remixes explizit Invarianten auf ("gleiche Einstellung, nur X ändern").
  • Wenn ein kritisches Detail fehlt und den Erfolg blockiert, stellen Sie eine Frage; andernfalls fortfahren.
  • Wenn Sie eine strukturierte Prompt-Datei an das CLI übergeben, fügen Sie --no-augment hinzu, um ein erneutes Umhüllen durch das Tool zu vermeiden.

Beispiele

Generierungsbeispiel (Einzeleinstellung)

Use case: Produkt-Teaser
Primary request: Nahaufnahme einer mattschwarzen Kamera auf einem Sockel
Action: langsame 30-Grad-Umrundung über 4 Sekunden
Camera: 85mm, geringe Schärfentiefe, sanftes Handheld-Drifts
Lighting/mood: weiches Schlüssellicht, subtiler Rand, erstklassiges Studio-Feeling
Constraints: keine Logos, kein Text

Remix-Beispiel (Invarianten)

Primary request: gleiche Einstellung und Bildausschnitt, Palette auf Teal/Sand/Rost mit wärmerem Gegenlicht umstellen
Constraints: Motiv und Kamerabewegung unverändert lassen

Best Practices für das Prompting (kurze Liste)

  • Eine Hauptaktion + eine Kamerabewegung pro Einstellung.
  • Verwenden Sie Zählungen oder Beats für das Timing ("zwei Schritte, Pause, Drehung").
  • Halten Sie Text kurz und die Kamera für UI- oder Bildschirmtexte fixiert.
  • Fügen Sie eine kurze Vermeidungszeile hinzu, wenn Artefakte auftreten (Flackern, Wackeln, schnelle Bewegung).
  • Kürzere Prompts sind kreativer; längere Prompts sind kontrollierter.
  • Dialog in einen dedizierten Block setzen; Zeilen kurz halten für 4-8s-Clips.
  • Invarianten bei Remixes explizit angeben (gleiche Einstellung, gleiche Kamerabewegung).
  • Mit Einzeländerungen iterieren, um die Kontinuität zu wahren.

Anleitung nach Asset-Typ

Verwenden Sie diese Module, wenn die Anfrage für ein bestimmtes Artefakt gilt. Sie bieten gezielte Vorlagen und Standardwerte.

  • Filmische Aufnahmen: references/cinematic-shots.md
  • Social Ads: references/social-ads.md

CLI + Umgebungsnotizen

  • CLI-Befehle + Beispiele: references/cli.md
  • API-Parameter-Kurzreferenz: references/video-api.md
  • Prompt-Anleitung: references/prompting.md
  • Beispiel-Prompts: references/sample-prompts.md
  • Fehlerbehebung: references/troubleshooting.md
  • Netzwerk/Sandbox-Tipps: references/codex-network.md

Referenzkarte

  • references/cli.md: Ausführung von create/poll/remix/download/batch via scripts/sora.py.
  • references/video-api.md: API-Einstellungen (Modelle, Größen, Dauer, Varianten, Status).
  • references/prompting.md: Prompt-Struktur und Iterationsanleitung.
  • references/sample-prompts.md: Kopier-/Einfüge-Prompt-Rezepte (nur Beispiele; keine zusätzliche Theorie).
  • references/cinematic-shots.md: Vorlagen für filmische Aufnahmen.
  • references/social-ads.md: Vorlagen für kurze Social-Ad-Beats.
  • references/troubleshooting.md: Häufige Fehler und Lösungen.
  • references/codex-network.md: Netzwerk-/Genehmigungs-Fehlerbehebung.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Verwandte Skills