Communitygithub.com

jayfirke/motion-studio

Configure o workspace motion-studio em uma nova máquina para seu proprietário — verifica ferramentas, instala o que está faltando (com sua aprovação), escreve o OWNER.md a partir de algumas perguntas simples, armazena as chaves de API com segurança (Keychain no macOS, cofre de segredos ou arquivo privado no Linux e WSL 2) e escreve o marcador de configuração local. Use quando a nota de início de sessão disser FIRST RUN, quando alguém disser "configure o motion-studio", "configure este workspace", "instale tudo", "adicione minhas chaves de API", "não funciona no meu computador", ou logo após clonar o repositório.

O que é motion-studio?

Esta habilidade automatiza a configuração inicial do workspace motion-studio em uma nova máquina, garantindo que todas as ferramentas, dependências e chaves de API estejam corretamente instaladas e configuradas. Ela é executada no macOS (Apple Silicon), Linux (Ubuntu 22.04+, Debian 12+) e Windows via WSL 2. A habilidade verifica as ferramentas existentes, instala as que estão faltando com a aprovação do usuário, coleta preferências do proprietário para gerar o arquivo OWNER.md e armazena chaves de API de forma segura usando o Keychain do macOS ou um cofre de segredos/arquivo privado no Linux/WSL 2. Também oferece instalações opcionais como o modelo Whisper para legendas, o Diffusion Studio para edição de vídeo e o conector Fish Audio para narração. A habilidade prioriza a segurança ao nunca solicitar chaves de API no chat e ao instruir o usuário a usar um script separado para armazená-las. Ela se baseia no script de verificação `doctor.sh` para determinar o estado do sistema e orienta o usuário passo a passo, explicando cada etapa em linguagem simples, mesmo para usuários não técnicos.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Configuração do workspace

Executa no macOS (Apple Silicon), Linux com apt (Ubuntu 22.04+, Debian 12+) e Windows através do WSL 2. Este repositório contém as regras, habilidades, ferramentas, sons CC0 compartilhados, Previs Studio e um filme de demonstração, mas nada vinculado a uma máquina ou pessoa: sem chaves de API, sem .venv, sem node_modules, sem habilidades ou plugins de nível de usuário, sem OWNER.md. Esta habilidade leva o proprietário a um estúdio funcional. SETUP.md é o mesmo procedimento escrito para pessoas.

Converse com o proprietário em palavras simples. Ele pode não ser técnico e pode não saber nada sobre design de movimento. Um passo de cada vez, diga o que faz, por que e quanto tempo leva.

Regras rígidas

  • Nunca peça uma chave de API no chat, e nunca digite, ecoe, registre ou escreva uma. As chaves são inseridas através de scripts/setup/keys.sh, que o proprietário executa em seu próprio terminal com digitação oculta (Keychain do macOS; no Linux/WSL 2, o cofre de segredos ou ~/.config/motion-studio/keys.env). Se eles colarem uma chave no chat de qualquer forma: não a use ou armazene. Diga a eles que agora está no histórico do chat, peça para excluir essa chave no site do provedor e criar uma nova, depois armazenar a nova com keys.sh.
  • As instalações são para eles aprovarem (AGENTS.md "Pergunte primeiro"). Pergunte com AskUserQuestion antes de executar qualquer etapa do install.sh e informe o tamanho do download.
  • Nunca execute sudo você mesmo. No macOS, o instalador do Homebrew precisa da senha deles; no Linux/WSL 2, bash scripts/setup/install.sh system (apt) precisa. Eles executam esse comando em seu próprio terminal. (Em uma sessão cloud do Claude Code você é root, então pode executá-lo.)

Passos

  1. Ainda não está no repositório? Se a pasta atual não for uma cópia do motion-studio (sem AGENTS.md com "motion-studio" e sem scripts/setup/), clone primeiro: git clone https://github.com/jayfirke/motion-studio.git motion-studio (pergunte onde, padrão: uma pasta motion-studio no diretório inicial ou atual), depois trabalhe dentro dela. Diga a eles que no final eles abrem uma nova sessão dentro dessa pasta.
  2. Diga olá e defina expectativas em 3 linhas: o que a configuração faz (verificar ferramentas, instalar as que faltam, escrever suas preferências, armazenar suas chaves), cerca de 15–30 minutos, cerca de 3 GB de downloads (pacotes do sistema, Chromium, o modelo Whisper de 1,6 GB). Diga qual sistema o doctor encontrou (macOS, Linux ou WSL 2).
  3. Verifique: execute bash scripts/setup/doctor.sh. Resuma as linhas NEED em palavras simples (para que serve cada uma), depois as linhas OPT em uma frase.
  4. Ferramentas do sistema.
    • macOS sem Homebrew: peça para eles executarem o instalador oficial de https://brew.sh no Terminal eles mesmos (pede a senha), depois siga as linhas "Next steps" que ele imprime.
    • Linux / WSL 2: peça para eles executarem bash scripts/setup/install.sh system em seu próprio terminal (apt precisa da senha; também compila whisper-cli e instala Node 22 e uv). No Linux ARM, ele imprime uma linha export HYPERFRAMES_BROWSER_PATH=… para adicionar ao perfil do shell. Aguarde "concluído", depois execute doctor novamente.
  5. Escolha as instalações com uma AskUserQuestion (multiSelect). Ofereça apenas o que doctor marcou como ausente:
    • "Core studio" = install.sh core no macOS (ferramentas Homebrew, venv Python, habilidades Claude, plugins Claude); no Linux/WSL 2, após a etapa system, install.sh venv skills plugins. Recomendado.
    • "Modelo Whisper, 1,6 GB" = install.sh whisper-model (temporizações de palavras para legendas e verificações de voz). Recomendado.
    • "Pacotes Previs Studio" = install.sh app (para reconstruir o Previs Studio e executar suas verificações).
    • "onetake" = install.sh onetake: experimentos pessoais e não comerciais apenas (PolyForm Noncommercial).
    • "Motion Reel Kit" = install.sh motion-reel <pasta do kit>: apenas se eles compraram ou baixaram o kit de seu criador (veja CREDITS.md); não está neste repositório. Execute as etapas aprovadas a partir da raiz do workspace. Etapas longas (brew, whisper-model) vão em segundo plano; diga a eles o que está sendo executado. Uma etapa imprime FAIL … com a correção: tente a correção uma vez, depois explique e pergunte.
  6. Preferências deles. Copie OWNER.example.md para OWNER.md, depois faça as perguntas em uma ou duas rodadas de AskUserQuestion (nome, o que fazem, uso pessoal ou comercial, experiência em design de movimento, voz padrão, nível de qualidade, orçamento e aprovações). Escreva as respostas em OWNER.md nas palavras deles. Ele é ignorado pelo git e nunca compartilhado.
  7. Chaves de API. Pergunte com AskUserQuestion quais eles querem agora:
    • Fish Audio (necessário para cada narração; conta gratuita; o modelo gratuito s2.1-pro-free é gratuito até 2026-11-30): chave em https://fish.audio/app/api-keys/.
    • Freesound (opcional; apenas para pesquisar e baixar novos efeitos sonoros; conta gratuita): solicite em https://freesound.org/apiv2/apply/ e copie "Client secret/Api key" e "Client id". Então peça para eles executarem bash scripts/setup/keys.sh em seu próprio terminal:
    • No aplicativo de desktop Claude, se você tiver uma ferramenta de terminal (run_in_terminal), inicie cd "<workspace>" && bash scripts/setup/keys.sh no painel Terminal deles e diga para eles digitarem lá. Não leia o painel enquanto eles digitam.
    • Caso contrário, peça para eles abrirem um terminal (Terminal no macOS, terminal Linux ou WSL) e colar: cd <workspace> && bash scripts/setup/keys.sh. Quando eles disserem que está concluído, execute bash scripts/setup/doctor.sh --online. Ele confirma que as chaves funcionam sem mostrá-las.
  8. Extras opcionais (uma lista curta, eles escolhem):
    • Diffusion Studio (corte de filmagens reais, máscaras de objetos): no macOS eles baixam o aplicativo de https://diffusion.studio, abrem uma vez, depois você executa install.sh diffusion-mcp. No Linux, ele funciona como um aplicativo web (https://app.diffusion.studio) sem o MCP.
    • O conector Fish Audio no claude.ai (Configurações → Conectores). Não é necessário; os scripts usam a chave.
    • Remotion é gratuito para indivíduos e empresas de até 3 pessoas; empresas maiores precisam de uma licença Remotion.
  9. Finalizar. Escreva .local/setup.json (crie .local/; ele é ignorado pelo git):
    {"owner": "<primeiro nome>", "setup_at": "<horário UTC de date -u +%Y-%m-%dT%H:%M:%SZ>", "by": "workspace-setup", "doctor": "<a linha DOCTER>"}
    
    Execute bash scripts/setup/session-check.sh (agora não deve imprimir nada) e doctor mais uma vez. Relate o que está pronto e o que foi ignorado.
  10. Diga a eles o que vem a seguir:
    • Inicie uma nova sessão do Claude Code nesta pasta. Habilidades, plugins e o Diffusion MCP carregam apenas no início da sessão.
    • Abra a demonstração: python3 -m http.server 8790 --directory _shared/previs/studio, depois http://localhost:8790 (Previs Studio com o filme de demonstração Crumb).
    • Um primeiro prompt para experimentar: "Crie um vídeo de lançamento de 15 segundos para . Previs primeiro."

Reexecutando

Execute bash scripts/setup/doctor.sh a qualquer momento. bash scripts/setup/install.sh <etapa> repete uma etapa com segurança. Exclua .local/setup.json para executar toda esta configuração novamente.

Individual skills in this repo

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

Habilidades Relacionadas