Motion Skills
← Guias

Como instalar um skill no Claude Code, no Codex ou no Cursor

Um skill é uma pasta com um arquivo SKILL.md (instruções para o agente), além de modelos e scripts. Instale uma vez e o seu agente vai usá-lo sempre que um pedido combinar. A mesma pasta funciona no Claude Code, no Codex, no Cursor e no Gemini CLI; só muda o lugar onde ela fica.

Os locais das pastas vêm da documentação de cada agente, conferida em 29 de outubro de 2026.

O que é um skill

Os skills seguem o formato aberto Agent Skills. Um skill é uma única pasta, com o nome do skill, contendo:

  • SKILL.md: as instruções. Um cabeçalho curto traz o name do skill e uma description de quando usá-lo; o agente lê a descrição para decidir se um pedido combina, e o restante quando combina.
  • Referências: anotações mais longas que as instruções indicam, lidas só quando necessário.
  • Modelos e scripts: os arquivos que o agente copia ou executa, como um modelo de vídeo, um arquivo de briefing ou uma verificação.

Nada é instalado no sistema todo e nenhuma conta é criada: o agente lê a pasta, e os comandos do skill rodam no seu projeto.

O jeito mais rápido: peça ao seu agente

Copie o prompt de instalação de qualquer página de skill e cole no seu agente:

Read https://claude-motion.com/skills/<slug>/install.md and follow it to install the "<slug>" skill, then make a first video with it.

O agente lê o guia e executa um comando, npx motion-skills install <slug>. Na primeira vez, uma página abre no seu navegador: entre com o Google e aprove o código que o seu terminal mostra. Se for um skill pago que você ainda não tem, a mesma página permite comprá-lo, e a instalação termina sozinha. Depois o agente faz um primeiro vídeo. (Se o comando não puder rodar, o guia passa para um download no seu navegador.)

Instalação manual

  1. Baixe o ZIP na página do skill.
  2. Descompacte mantendo o nome da pasta (<slug>/SKILL.md):
    • Claude Code: ~/.claude/skills/<slug>/, ou .claude/skills/<slug>/ dentro de um projeto
    • Codex: ~/.agents/skills/<slug>/
    • Cursor: .cursor/skills/<slug>/ dentro do projeto
    • Gemini CLI: ~/.gemini/skills/<slug>/
  3. Abra uma nova sessão do agente para que ele carregue o skill.
mkdir -p ~/.claude/skills
unzip -o ~/Downloads/kinetic-type-title.zip -d ~/.claude/skills/

O que você precisa no seu computador

  • Node.js 22 ou mais recente
  • FFmpeg (brew install ffmpeg no macOS)
  • Google Chrome (o renderizador o controla em modo headless)

Os skills de vídeo completo e o skill gratuito Motion Director rodam no nosso motor aberto motion-skills (mo), que se instala sozinho via npx na primeira vez que renderiza; os modelos de animação usam a CLI do HyperFrames, que se instala do mesmo jeito. Nenhuma chave de API é necessária.

Usando um skill

Com um modelo de animação, é só pedir: "Faça uma cartela de título em 9:16 com o texto Ship faster, sleep better." O agente copia o modelo, escreve um brief.json, roda hyperframes check, olha quadros de amostra para pegar problemas de layout, depois renderiza o MP4 e diz onde ele está.

Com um skill de vídeo completo, entregue o seu material ao agente e diga para que serve o vídeo. Ele mostra três direções como quadros reais, escreve uma folha de ritmo e uma música original, roda as verificações do mo e uma revisão, depois renderiza o MP4 no seu próprio Chrome.

Para um passo a passo completo com um vídeo de exemplo real, veja Como fazer um vídeo com o Claude Code. Para o Codex, o Cursor ou o Gemini CLI, com todas as pastas que cada um lê, veja Fazer vídeos com Codex, Cursor ou Gemini CLI.

Solução de problemas

  • O agente não usa o skill. Abra uma nova sessão depois de instalar; os agentes leem os seus skills quando uma sessão começa (no Gemini CLI, /skills reload faz isso na hora). Depois peça de novo, citando o nome do skill: "use the changelog-video skill". Confira também a pasta: o SKILL.md precisa ficar diretamente dentro de <slug>/, e não um nível abaixo depois de descompactar.
  • "FFmpeg not found". Instale-o (brew install ffmpeg no macOS) e abra um novo terminal para que ele esteja no seu path.
  • "Chrome not found". Instale o Google Chrome; o renderizador o controla em modo headless. Os skills de vídeo completo verificam isso para você logo no início com mo doctor, e os modelos de animação com node kit/doctor.mjs.
  • A página de login não abre. O terminal mostra o endereço e o código; abra o endereço você mesmo e digite o código.

Perguntas

Onde coloco um skill para o Claude Code?

Em ~/.claude/skills/<slug>/ para todos os projetos, ou em .claude/skills/<slug>/ dentro de um projeto. A pasta mantém o nome do skill e guarda o SKILL.md dele. Abra uma nova sessão do Claude Code para que ele carregue o skill.

O que é o SKILL.md?

Um arquivo de instruções para o agente, dentro de uma pasta de skill com modelos e scripts. O cabeçalho dele dá o nome do skill e diz quando usá-lo; o agente o lê quando um pedido combina.

Os skills funcionam no Codex, no Cursor e no Gemini CLI?

Sim. A mesma pasta funciona em cada um; só muda o local: ~/.agents/skills/<slug>/ para o Codex, .cursor/skills/<slug>/ no projeto para o Cursor e ~/.gemini/skills/<slug>/ para o Gemini CLI.

Preciso de uma chave de API?

Não. Os skills rodam no seu computador com Node.js, FFmpeg e Chrome, e os motores se instalam sozinhos via npx. O único login é uma conta gratuita do Google neste site, para baixar.