Communitygithub.com

avenoxai/avenoxskills

Avenox Studio – eine lokale, agentenbetriebene YouTube-Videoproduktions-Pipeline (ROUTER, zuerst lesen). Zuständig für alle Anfragen zum Bearbeiten, Schneiden, Produzieren, Zusammenbauen, Untertiteln, Vertonen oder Rendern von Langform-Videos sowie zur Erstellung von Bewegtgrafiken.

Was ist avenoxskills?

Avenox Studio ist eine vollständig lokale, agentenbetriebene Videoproduktions-Pipeline, die speziell für die Erstellung von YouTube-Langform-Videos entwickelt wurde. Sie kapselt Open-Source-Werkzeuge wie auto-editor, mlx-whisper, MLT/melt und ffmpeg sowie HyperFrames für animierte Grafiken. Der menschliche Regisseur gibt Anweisungen und prüft die Qualität, während der KI-Agent als Operator die gesamte Pipeline ausführt – vom Rohschnitt über Grafiken und Untertitel bis zum finalen Rendering. Das System läuft ausschließlich auf dem eigenen Rechner, ohne Cloud-Editor oder Upload, und setzt auf macOS (Apple Silicon) mit ffmpeg, Python und Node. Es folgt einem strengen 7-Schritte-Workflow: Aufnahme, Rohschnitt, Grafiken, Zusammenbau, Untertitel, Musik und Export mit einer Director-Review-Schleife vor dem finalen Rendering. Markenrichtlinien werden über eine zentrale Brand-Datei erzwungen, und die Pipeline erzeugt Vorschauen für die Freigabe, bevor das Endergebnis ausgegeben wird.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/avenoxai/avenoxskills/tree/HEAD/skills/avenox-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Avenox Studio – Operator-Router

Die schnelle Bedienungsanleitung für eine lokale, agentenbetriebene Videopipeline. Alles läuft auf Ihrem eigenen Rechner: keine Cloud-Editoren, kein Upload-zum-Rendern.

Der Mensch gibt Anweisungen und prüft die Qualität; der Agent führt die Pipeline aus.

Einrichtung

export STUDIO_JOBS="$HOME/video/projects"   # schwere Mediendateien leben hier
export STUDIO_ROOT="/path/to/this/repo"     # Skripte, Vorlagen, Markenrichtlinien

Voraussetzungen: macOS (Hardware-Encoding via h264_videotoolbox; Apple Silicon für mlx-whisper), ffmpeg, python3, melt/MLT, Node (für HyperFrames). Das meiste davon funktioniert auch unter Linux mit libx264 und einer ersetzten CUDA-Whisper-Build.

Betriebsprinzipien

  1. Mediendisziplin. Schwere Medien NIEMALS in einem cloud-synchronisierten Ordner – Synchronisation würde bei Multi-GB-Zwischenprodukten überlasten und laufende Schreibvorgänge beschädigen. Aufträge liegen in $STUDIO_JOBS/<job>/ (raw/ cut/ graphics/ audio/ outputs/). Ihr Notizsystem enthält nur das Gehirn: dieses System, die Markenrichtlinie, edit.json-Pläne.
  2. Regie-Schleife. Erzeugen Sie eine Vorschau (Grafik-Standbilder + schneller Entwurfsrender) → zur Freigabe senden → erst dann final rendern. Niemals ein Finale ohne Freigabe ausliefern. Dies ist die mit Abstand wichtigste Regel; ein Agent, der Finals ungeprüft rendert, verbrennt Stunden mit einem abgelehnten Schnitt.
  3. Marke ist eine harte Einschränkung, kein Vorschlag. Lesen Sie brand/frame.md, bevor Sie Grafiken erstellen. Definieren Sie sie einmal und sperren Sie sie. (Die Referenzimplementierung ist bewusst anti-"KI-Schrott": hochwertiger Redaktionsstil, warmes Papier + Tinte + ein einzelner Akzent, kein Neon/Gradient/Glassmorphismus/3D-Glanz.)
  4. Format: YouTube 16:9 1080p60. Voreinstellung in brand/presets/youtube-16x9.json.
  5. Feinschliff ist hybrid. Automatisch den Entwurf erzeugen; die gleiche .mlt-Datei öffnet in Kdenlive oder Shotcut für manuelle Nachbearbeitung. Versuchen Sie nicht, Geschmack zu automatisieren.
  6. Transkription standardmäßig LOKAL mit mlx-whisper und whisper-large-v3-turbo – schnell, kostenlos und stark bei nicht-englischen Audioinhalten. Beachten Sie, dass die meisten LLM-Routing-Proxys keinen Whisper-Endpunkt bereitstellen; wenn Sie remote arbeiten, verwenden Sie eine spezielle Sprach-API.

Skripte (scripts/)

SkriptFunktion
autocut.sh IN.mp4 [balanced|aggressive|conservative]Stille schneiden → _cut.xml (Premiere) oder --export-Varianten
transcribe.py IN.mp4 PREFIX→ transcript/PREFIX_timed.json + _narration.txt
mltgen.py edit.json out.mlt --base <job-dir>Schnittliste → MLT-Projekt (Kdenlive/Shotcut/melt)
vrender.sh project.mlt out.mp4 [fast|quality]Rendern (fast = HW-Entwurf, quality = CRF18-Master)
grabshot.shZwischenablage-Screenshot → Festplatte
slides2png.shLegacy-Statische Folien – HyperFrames bevorzugen
remove-silence.pyEigenständiger Stille-Durchgang

Die 7 Schritte

  1. Aufnahme – Rohmaterial kopieren → $STUDIO_JOBS/<job>/raw/. Briefing bestätigen und festlegen, welche Segmente wirklich wichtig sind.
  2. Rohschnitt – autocut.sh raw.mov balanced → cut/screen_cut.mp4; transcribe.py für das Skript. Vollständiges Rezept → avenox-roughcut-Skill.
  3. Grafiken – HyperFrames. Über den hyperframes-Skill routen → normalerweise motion-graphics (kurze Beats), faceless-explainer (Konzeptstrecken) oder general-video. Zuerst brand/frame.md lesen; animierte MP4s in graphics/ rendern. Vollständiges Rezept → avenox-graphics-Skill.
  4. Zusammenbau – edit.json schreiben (Vorlage in templates/edit.json) mit cut/*.mp4 + graphics/*.mp4 + Musik mischen → mltgen.py edit.json project.mlt --base <job-dir>.
  5. Untertitel – transcribe.py → .srt; brand/caption-corrections.json anwenden (kopieren Sie es von caption-corrections.example.json – eine Suchen/Ersetzen-Tabelle für Begriffe, die Ihre ASR zuverlässig verunstaltet). Als YouTube CC ausliefern, nicht eingebrannt.
  6. Musik – Hintergrund unter alles, Sidechain-Ducking unter Sprache, Ziel ~-14 LUFS. Quellenangabe in CREDITS.md.
  7. Export – vrender.sh project.mlt draft.mp4 fast → Regie-Prüfung → vrender.sh … final.mp4 quality → temporäre Dateien löschen.

Grafik-Qualitätsmaßstab

HyperFrames-Clips müssen brand/frame.md einhalten. Bevorzugen Sie typgetriebene, zurückhaltende, gewichtige Bewegung. Wenn ein Beat keine Bewegung braucht, ist ein sauberes Standbild in Ordnung – bewegen Sie nicht um der Bewegung willen.

Referenz

  • Rohschnitt: avenox-roughcut · Grafiken: avenox-graphics
  • HyperFrames-Skills: hyperframes (Router), hyperframes-cli, hyperframes-animation, hyperframes-creative, motion-graphics, faceless-explainer, general-video
  • Markenrichtlinie: brand/frame.md (ausfüllen nach brand/frame.template.md)

Verwandte Skills