Communitygithub.com

jayfirke/motion-studio

Configurer l'espace de travail motion-studio sur une nouvelle machine pour son propriétaire : vérifier les outils, installer ce qui manque (avec son accord), écrire OWNER.md à partir de quelques questions simples, stocker ses clés API en toute sécurité (Trousseau macOS, coffre-fort secret ou fichier privé sur Linux et WSL 2), et écrire le marqueur de configuration locale. À utiliser quand la note de début de session indique PREMIER LANCEMENT, ou quand quelqu'un dit « configure motion-studio », « configure cet espace de travail », « installe tout », « ajoute mes clés API », « ça ne marche pas sur mon ordinateur », ou juste après avoir cloné le dépôt.

Qu'est-ce que motion-studio ?

Cette compétence configure l'ensemble de l'espace de travail motion-studio sur une nouvelle machine pour son propriétaire. Elle est conçue pour être exécutée par des agents IA (Claude Code) sur macOS (Apple Silicon), Linux (Ubuntu 22.04+, Debian 12+) et Windows via WSL 2. Le processus guide l'utilisateur étape par étape : vérification des outils système, installation des dépendances manquantes (Homebrew, apt, Python venv, Node, outils CLI), collecte des préférences utilisateur dans OWNER.md, et stockage sécurisé des clés API (Fish Audio, Freesound) via un script shell dédié qui évite toute exposition dans le chat. Elle insiste sur la sécurité : jamais de clés API dans l'historique de chat, installations toujours approuvées par l'utilisateur, et pas d'exécution de `sudo` par l'agent. Une fois terminée, elle écrit un fichier de configuration locale et lance une vérification finale. Cette compétence est idéale pour les nouveaux utilisateurs non techniques qui veulent démarrer avec le motion design, ou pour quiconque clône le dépôt et a besoin d'une configuration rapide et fiable.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Configuration de l'espace de travail

Fonctionne sur macOS (Apple Silicon), Linux avec apt (Ubuntu 22.04+, Debian 12+) et Windows via WSL 2. Ce dépôt contient les règles, compétences, outils, sons CC0 partagés, Previs Studio et un film de démonstration, mais rien lié à une machine ou à une personne : pas de clés API, pas de .venv, pas de node_modules, pas de compétences ou plugins utilisateur, pas de OWNER.md. Cette compétence met le propriétaire en état de travailler dans son studio. SETUP.md est la même procédure écrite pour les humains.

Parlez au propriétaire en termes simples. Il n'est peut-être pas technique, et il ne connaît peut-être rien au motion design. Une étape à la fois, dites ce que fait chaque étape, pourquoi, et combien de temps elle prend.

Règles strictes

  • Ne demandez jamais une clé API dans le chat, et ne tapez, affichez, enregistrez ou écrivez jamais une clé. Les clés sont entrées via scripts/setup/keys.sh, que le propriétaire exécute dans son propre terminal avec saisie masquée (Trousseau macOS ; sur Linux/WSL 2, le coffre-fort secret ou ~/.config/motion-studio/keys.env). S'ils collent une clé dans le chat malgré tout : ne l'utilisez pas et ne la stockez pas. Dites-leur qu'elle est maintenant dans l'historique du chat, demandez-leur de supprimer cette clé sur le site du fournisseur et d'en créer une nouvelle, puis stockez la nouvelle avec keys.sh.
  • Les installations doivent être approuvées par eux (AGENTS.md « Demander d'abord »). Demandez avec AskUserQuestion avant d'exécuter une étape install.sh, et indiquez la taille du téléchargement.
  • N'exécutez jamais sudo vous-même. Sur macOS, l'installateur de Homebrew a besoin de leur mot de passe ; sur Linux/WSL 2, bash scripts/setup/install.sh system (apt) en a besoin. Ils exécutent cette unique commande dans leur propre terminal. (Dans une session cloud Claude Code, vous êtes root, vous pouvez donc l'exécuter.)

Étapes

  1. Pas encore dans le dépôt ? Si le dossier actuel n'est pas une copie de motion-studio (pas de AGENTS.md avec « motion-studio » et pas de scripts/setup/), clonez-le d'abord : git clone https://github.com/jayfirke/motion-studio.git motion-studio (demandez où, par défaut : un dossier motion-studio dans leur dossier personnel ou actuel), puis travaillez à l'intérieur. Dites-leur qu'à la fin, ils ouvrent une nouvelle session dans ce dossier.
  2. Dites bonjour et définissez les attentes en 3 lignes : ce que fait la configuration (vérifier les outils, installer ceux qui manquent, écrire leurs préférences, stocker leurs clés), environ 15 à 30 minutes, environ 3 Go de téléchargements (paquets système, Chromium, le modèle Whisper de 1,6 Go). Dites quel système a été détecté (macOS, Linux ou WSL 2).
  3. Vérification : exécutez bash scripts/setup/doctor.sh. Résumez les lignes NEED en termes simples (à quoi chacune sert), puis les lignes OPT en une phrase.
  4. Outils système.
    • macOS sans Homebrew : demandez-leur d'exécuter l'installateur officiel depuis https://brew.sh dans le Terminal eux-mêmes (il demande leur mot de passe), puis suivez les lignes « Prochaines étapes » qu'il affiche.
    • Linux / WSL 2 : demandez-leur d'exécuter bash scripts/setup/install.sh system dans leur propre terminal (apt a besoin de leur mot de passe ; il construit aussi whisper-cli et installe Node 22 et uv). Sur Linux ARM, il affiche une ligne export HYPERFRAMES_BROWSER_PATH=… à ajouter à leur profil shell. Attendez « terminé », puis exécutez doctor à nouveau.
  5. Choisir les installations avec une seule AskUserQuestion (sélection multiple). Proposez uniquement ce que doctor a marqué comme manquant :
    • « Studio de base » = install.sh core sur macOS (outils Homebrew, environnement Python virtuel, compétences Claude, plugins Claude) ; sur Linux/WSL 2, après leur étape system, install.sh venv skills plugins. Recommandé.
    • « Modèle Whisper, 1,6 Go » = install.sh whisper-model (synchronisation temporelle des mots pour les sous-titres et vérifications vocales). Recommandé.
    • « Paquets Previs Studio » = install.sh app (pour reconstruire Previs Studio et exécuter ses vérifications).
    • « onetake » = install.sh onetake : expériences personnelles non commerciales uniquement (PolyForm Noncommercial).
    • « Motion Reel Kit » = install.sh motion-reel <dossier du kit> : seulement s'ils ont acheté ou téléchargé le kit auprès de son créateur (voir CREDITS.md) ; il n'est pas dans ce dépôt. Exécutez les étapes approuvées depuis la racine de l'espace de travail. Les étapes longues (brew, whisper-model) se déroulent en arrière-plan ; dites-leur ce qui s'exécute. Si une étape affiche FAIL … avec le correctif : essayez le correctif une fois, puis expliquez et demandez.
  6. Leurs préférences. Copiez OWNER.example.md vers OWNER.md, puis posez ses questions en un ou deux tours de AskUserQuestion (nom, ce qu'ils créent, utilisation personnelle ou commerciale, expérience en motion design, voix par défaut, niveau de qualité, budget et approbations). Écrivez les réponses dans OWNER.md dans leurs mots. Ce fichier est ignoré par git et jamais partagé.
  7. Clés API. Demandez avec AskUserQuestion lesquelles ils veulent maintenant :
    • Fish Audio (nécessaire pour chaque voix off ; compte gratuit ; le modèle gratuit s2.1-pro-free est gratuit jusqu'au 30/11/2026) : clé sur https://fish.audio/app/api-keys/.
    • Freesound (facultatif ; uniquement pour rechercher et télécharger de nouveaux effets sonores ; compte gratuit) : demandez sur https://freesound.org/apiv2/apply/ et copiez « Client secret/Api key » et « Client id ». Ensuite, demandez-leur d'exécuter bash scripts/setup/keys.sh dans leur propre terminal :
    • Dans l'application de bureau Claude, si vous avez un outil de terminal (run_in_terminal), démarrez cd "<workspace>" && bash scripts/setup/keys.sh dans leur panneau Terminal et dites-leur de taper dedans. Ne lisez pas le panneau pendant qu'ils tapent.
    • Sinon, demandez-leur d'ouvrir un terminal (Terminal sur macOS, leur terminal Linux ou WSL) et de coller : cd <workspace> && bash scripts/setup/keys.sh. Quand ils disent que c'est fait, exécutez bash scripts/setup/doctor.sh --online. Cela confirme que les clés fonctionnent sans les afficher.
  8. Extras facultatifs (une courte liste, ils choisissent) :
    • Diffusion Studio (montage de séquences réelles, masques d'objets) : sur macOS, ils téléchargent l'application depuis https://diffusion.studio, l'ouvrent une fois, puis vous exécutez install.sh diffusion-mcp. Sur Linux, il fonctionne comme une application web (https://app.diffusion.studio) sans le MCP.
    • Le connecteur Fish Audio dans claude.ai (Paramètres → Connecteurs). Pas nécessaire ; les scripts utilisent la clé.
    • Remotion est gratuit pour les particuliers et les entreprises de jusqu'à 3 personnes ; les entreprises plus grandes ont besoin d'une licence Remotion.
  9. Terminer. Écrivez .local/setup.json (créez .local/ ; il est ignoré par git) :
    {"owner": "<prénom>", "setup_at": "<heure UTC depuis date -u +%Y-%m-%dT%H:%M:%SZ>", "by": "workspace-setup", "doctor": "<la ligne DOCTER>"}
    
    Exécutez bash scripts/setup/session-check.sh (il ne devrait rien afficher maintenant) et doctor une fois de plus. Rapportez ce qui est prêt et ce qui a été ignoré.
  10. Dites-leur la suite :
    • Démarrez une nouvelle session Claude Code dans ce dossier. Les compétences, plugins et le MCP Diffusion ne se chargent qu'au démarrage de la session.
    • Ouvrez la démo : python3 -m http.server 8790 --directory _shared/previs/studio, puis http://localhost:8790 (Previs Studio avec le film de démonstration Crumb).
    • Une première invite à essayer : « Fais une bande-annonce de lancement de 15 secondes pour . Previs d'abord. »

Réexécution

bash scripts/setup/doctor.sh à tout moment. bash scripts/setup/install.sh <étape> répète une étape en toute sécurité. Supprimez .local/setup.json pour exécuter toute cette configuration à nouveau.

Individual skills in this repo

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

Skills associés