Communitygithub.com

jayfirke/motion-studio

Richtet einen motion-studio-Arbeitsbereich auf einem neuen Rechner für seinen Besitzer ein – überprüft Werkzeuge, installiert fehlende (mit Zustimmung), erstellt OWNER.md, speichert API-Schlüssel sicher und setzt den lokalen Einrichtungsmarker.

Was ist motion-studio?

Diese Fähigkeit führt die vollständige maschinenspezifische Einrichtung eines motion-studio-Repositorys durch, das Regeln, Fähigkeiten, Werkzeuge, CC0-Sounds, Previs Studio und einen Demofilm enthält, aber keine API-Schlüssel, keine virtuellen Umgebungen, keine node_modules und keine OWNER.md-Datei. Es ist für macOS (Apple Silicon), Linux (Ubuntu 22.04+, Debian 12+) und Windows über WSL 2 konzipiert. Der Assistent begrüßt den Besitzer, führt ein Diagnoseskript (doctor.sh) aus, identifiziert fehlende Abhängigkeiten und bittet um Erlaubnis, System- und Projektwerkzeuge zu installieren (einschließlich Homebrew, apt-Pakete, Python-venv, Claude-Fähigkeiten/Plugins und das Whisper-Spracherkennungsmodell). Er erstellt eine personalisierte OWNER.md basierend auf kurzen Fragen (Name, Verwendungszweck, Erfahrungsniveau) und leitet den Besitzer dann an, seine API-Schlüssel sicher zu speichern – über die Keychain von macOS oder einen verschlüsselten Speicher unter Linux/WSL 2 –, wobei die Tastenanschläge aktiv verborgen und die Schlüssel im Chatverlauf vermieden werden. Der Assistent führt den Besitzer Schritt für Schritt durch die Einrichtung und bietet bei Bedarf Erklärungen in einfacher Sprache. Er kann auch optionale Extras wie Diffusion Studio, das Fish Audio Connector und die Einrichtung von Remotion verwalten. Durch die Verwendung eines lokalen JSON-Markers (`setup.json`) kann die gesamte Einrichtung problemlos wiederholt werden, ohne die Konfiguration zu beschädigen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jayfirke/motion-studio/tree/HEAD/.agents/skills/workspace-setup

In Ihrer bevorzugten KI fragen

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

Dokumentation

Arbeitsbereich einrichten

Läuft auf macOS (Apple Silicon), Linux mit apt (Ubuntu 22.04+, Debian 12+) und Windows über WSL 2. Dieses Repo enthält die Regeln, Fähigkeiten, Werkzeuge, gemeinsam genutzte CC0-Sounds, Previs Studio und einen Demofilm, aber nichts, das an einen Rechner oder eine Person gebunden ist: keine API-Schlüssel, kein .venv, keine node_modules, keine benutzerspezifischen Fähigkeiten oder Plugins, keine OWNER.md. Diese Fähigkeit bringt den Besitzer zu einem funktionierenden Studio. SETUP.md ist das gleiche Verfahren, geschrieben für Menschen.

Sprich mit dem Besitzer in einfachen Worten. Er ist möglicherweise nicht technisch versiert und weiß möglicherweise nichts über Motion Design. Schritt für Schritt, sag, was es tut, warum und wie lange es dauert.

Harte Regeln

  • Nie nach einem API-Schlüssel im Chat fragen und nie einen Schlüssel tippen, ausgeben, protokollieren oder schreiben. Schlüssel werden über scripts/setup/keys.sh eingegeben, das der Besitzer in seinem eigenen Terminal mit versteckter Eingabe ausführt (macOS Keychain; unter Linux/WSL 2 der Secret Store oder ~/.config/motion-studio/keys.env). Wenn jemand doch einen Schlüssel in den Chat einfügt: verwende oder speichere ihn nicht. Sag ihm, dass der Schlüssel jetzt im Chatverlauf ist, bitte ihn, diesen Schlüssel auf der Website des Anbieters zu löschen und einen neuen zu erstellen und dann den neuen mit keys.sh zu speichern.
  • Installationen müssen von ihnen genehmigt werden (AGENTS.md „Ask first“). Frage mit AskUserQuestion, bevor du einen install.sh-Schritt ausführst, und gib die Download-Größe an.
  • Führe niemals selbst sudo aus. Unter macOS benötigt das Homebrew-Installationsprogramm ihr Passwort; unter Linux/WSL 2 macht bash scripts/setup/install.sh system (apt) das. Sie führen diesen einen Befehl in ihrem eigenen Terminal aus. (In einer Claude Code Cloud-Sitzung bist du root, du kannst es also ausführen.)

Schritte

  1. Noch nicht im Repo? Wenn der aktuelle Ordner keine motion-studio-Kopie ist (keine AGENTS.md mit „motion-studio“ und kein scripts/setup/), klone es zuerst: git clone https://github.com/jayfirke/motion-studio.git motion-studio (frage wo, Standard: ein motion-studio-Ordner in ihrem Home- oder aktuellen Ordner), dann arbeite darin. Sag ihnen, dass sie am Ende eine neue Sitzung in diesem Ordner öffnen.
  2. Begrüßung und Erwartungen setzen in 3 Zeilen: was die Einrichtung macht (Werkzeuge prüfen, fehlende installieren, ihre Präferenzen schreiben, ihre Schlüssel speichern), ca. 15–30 Minuten, ca. 3 GB Downloads (Systempakete, Chromium, das 1,6 GB Whisper-Modell). Sag, welches System der Doktor gefunden hat (macOS, Linux oder WSL 2).
  3. Prüfen: führe bash scripts/setup/doctor.sh aus. Fasse die NEED-Zeilen in einfachen Worten zusammen (wofür jede ist), dann die OPT-Zeilen in einem Satz.
  4. Systemwerkzeuge.
    • macOS ohne Homebrew: bitte sie, das offizielle Installationsprogramm von https://brew.sh selbst im Terminal auszuführen (es fragt nach ihrem Passwort), dann die „Nächste Schritte“-Zeilen zu befolgen, die es ausgibt.
    • Linux / WSL 2: bitte sie, bash scripts/setup/install.sh system in ihrem eigenen Terminal auszuführen (apt benötigt ihr Passwort; es baut auch whisper-cli und installiert Node 22 und uv). Auf ARM Linux gibt es eine Zeile export HYPERFRAMES_BROWSER_PATH=… aus, die sie zu ihrem Shell-Profil hinzufügen sollen. Warte auf „done“, dann führe doctor erneut aus.
  5. Installationen auswählen mit einer AskUserQuestion (multiSelect). Biete nur das an, was der Doktor als fehlend markiert hat:
    • „Core studio“ = install.sh core auf macOS (Homebrew-Tools, Python venv, Claude-Fähigkeiten, Claude-Plugins); auf Linux/WSL 2, nach ihrem system-Schritt, install.sh venv skills plugins. Empfohlen.
    • „Whisper model, 1.6 GB“ = install.sh whisper-model (Wortzeitmarkierungen für Untertitel und Sprachüberprüfungen). Empfohlen.
    • „Previs Studio packages“ = install.sh app (um Previs Studio neu zu bauen und seine Prüfungen auszuführen).
    • „onetake“ = install.sh onetake: nur persönliche, nicht-kommerzielle Experimente (PolyForm Noncommercial).
    • „Motion Reel Kit“ = install.sh motion-reel <kit folder>: nur wenn sie das Kit von seinem Ersteller gekauft oder heruntergeladen haben (siehe CREDITS.md); es ist nicht in diesem Repo. Führe die genehmigten Schritte aus dem Arbeitsbereichsstamm aus. Lange Schritte (brew, whisper-model) laufen im Hintergrund; sag ihnen, was gerade läuft. Ein Schritt gibt FAIL … mit der Behebung aus: versuche die Behebung einmal, dann erkläre und frage.
  6. Ihre Präferenzen. Kopiere OWNER.example.md nach OWNER.md, frage dann ihre Fragen in einer oder zwei AskUserQuestion-Runden (Name, was sie machen, private oder kommerzielle Nutzung, Motion-Design-Erfahrung, Standardstimme, Qualitätsanspruch, Budget und Genehmigungen). Schreibe die Antworten in ihre eigenen Worte in OWNER.md. Es ist git-ignoriert und wird nie geteilt.
  7. API-Schlüssel. Frage mit AskUserQuestion, welche sie jetzt wollen:
    • Fish Audio (wird für jede Sprachausgabe benötigt; kostenloses Konto; das kostenlose Modell s2.1-pro-free ist bis 2026-11-30 kostenlos): Schlüssel unter https://fish.audio/app/api-keys/.
    • Freesound (optional; nur um neue Soundeffekte zu suchen und herunterzuladen; kostenloses Konto): beantrage unter https://freesound.org/apiv2/apply/ und kopiere „Client secret/Api key“ und „Client id“. Dann lass sie bash scripts/setup/keys.sh in ihrem eigenen Terminal ausführen:
    • In der Claude Desktop-App, wenn du ein Terminal-Werkzeug (run_in_terminal) hast, starte cd "<workspace>" && bash scripts/setup/keys.sh in ihrem Terminal-Panel und sag ihnen, sie sollen dort tippen. Lies das Panel nicht, während sie tippen.
    • Andernfalls bitte sie, ein Terminal zu öffnen (Terminal auf macOS, ihr Linux- oder WSL-Terminal) und einzufügen: cd <workspace> && bash scripts/setup/keys.sh. Wenn sie sagen, dass es fertig ist, führe bash scripts/setup/doctor.sh --online aus. Es bestätigt, dass die Schlüssel funktionieren, ohne sie anzuzeigen.
  8. Optionale Extras (eine kurze Liste, sie wählen):
    • Diffusion Studio (echtes Filmmaterial schneiden, Objektmasken): auf macOS laden sie die App von https://diffusion.studio herunter, öffnen sie einmal, dann führst du install.sh diffusion-mcp aus. Auf Linux läuft es als Web-App (https://app.diffusion.studio) ohne das MCP.
    • Der Fish Audio-Konnektor in claude.ai (Einstellungen → Konnektoren). Nicht erforderlich; die Skripte verwenden den Schlüssel.
    • Remotion ist kostenlos für Einzelpersonen und Unternehmen mit bis zu 3 Personen; größere Unternehmen benötigen eine Remotion-Lizenz.
  9. Abschluss. Schreibe .local/setup.json (erstelle .local/; es ist git-ignoriert):
    {"owner": "<Vorname>", "setup_at": "<UTC-Zeit von date -u +%Y-%m-%dT%H:%M:%SZ>", "by": "workspace-setup", "doctor": "<die DOCTOR-Zeile>"}
    
    Führe bash scripts/setup/session-check.sh aus (es sollte jetzt nichts ausgeben) und doctor noch einmal. Berichte, was bereit ist und was übersprungen wurde.
  10. Sag ihnen, was als Nächstes kommt:
    • Starte eine neue Claude Code-Sitzung in diesem Ordner. Fähigkeiten, Plugins und das Diffusion MCP werden nur beim Start der Sitzung geladen.
    • Öffne die Demo: python3 -m http.server 8790 --directory _shared/previs/studio, dann http://localhost:8790 (Previs Studio mit dem Crumb-Demofilm).
    • Ein erster Prompt zum Ausprobieren: „Erstelle ein 15-Sekunden-Launch-Reel für . Zuerst Previs.“

Erneutes Ausführen

bash scripts/setup/doctor.sh jederzeit. bash scripts/setup/install.sh <step> führt einen Schritt sicher wiederholt aus. Lösche .local/setup.json, um die gesamte Einrichtung erneut auszuführen.

Individual skills in this repo

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

Verwandte Skills