Agent Skills para jogos: configurar Claude Code, Codex e Cursor

Instale gamedev-skills/awesome-gamedev-agent-skills na raiz do projeto do seu jogo com npx skills add gamedev-skills/awesome-gamedev-agent-skills, inclua router e selecione seu agente de programação. Depois, invoque o router explicitamente e valide uma pequena alteração no Godot ou no Unity antes de pedir uma funcionalidade maior. Instalar o catálogo completo não coloca o conteúdo de todas as skills no contexto: os agentes descobrem primeiro os metadados e leem as instruções selecionadas conforme a necessidade.

Em 2026-10-26, o repositório atual contém 76 skills especializadas e um router separado, totalizando 77 definições de skills. A descrição na seção About do repositório ainda informa 74; consulte os arquivos atuais e a prévia do instalador para conferir o que será instalado. O pacote usa a licença Apache-2.0.

Esta configuração é útil se você já usa um agente de programação e quer instruções reutilizáveis específicas para seu motor de jogo. O pacote oferece orientações para código e fluxos de trabalho; você ainda precisa do editor, do projeto e de uma conta ou configuração de API funcional no cliente do agente.

Instale no escopo do projeto

Comece com uma instalação local ao projeto para inspecionar os arquivos adicionados junto com o jogo. Em 2026-10-26, a versão publicada da CLI skills é 1.7.4 e exige Node.js 22.20.0 ou posterior, segundo os metadados do npm. Tenha também o Git disponível para buscar o repositório.

Abra o Bash na raiz do projeto e visualize o catálogo:

node --version
git --version
npx skills add gamedev-skills/awesome-gamedev-agent-skills --list

Procure router, godot-2d-movement, platformer e unity-scriptableobjects. A opção --list mostra as skills disponíveis sem instalá-las. Leia o router e as skills que pretende usar antes de confirmar a instalação.

Execute o comando de instalação documentado pelo pacote:

npx skills add gamedev-skills/awesome-gamedev-agent-skills

Nas opções interativas, inclua o router e o catálogo completo para seguir este guia, selecione o agente que usa e escolha o escopo Project. Acrescente -g somente se quiser instalar as skills no diretório do usuário para utilizá-las em vários projetos.

Para selecionar explicitamente o catálogo completo para o Codex, use esta alternativa:

npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill '*' -a codex

Troque codex por claude-code ou cursor para esses clientes. Mantenha as aspas em '*' para impedir que o Bash expanda o curinga. A referência da CLI diferencia --skill '*', que seleciona todas as skills, de --all, que também seleciona todos os agentes.

Confira o resultado:

npx skills list

Confirme que router e as skills necessárias para a verificação do motor escolhido aparecem na lista. O instalador busca arquivos públicos de skills; a autenticação do modelo continua configurada no cliente de programação, e executar o agente continua consumindo sua franquia normal de uso do modelo ou gerando cobrança pela API.

De onde Claude Code, Codex e Cursor carregam os arquivos?

Consulte o destino real da instalação, pois os diretórios aceitos pelo agente nem sempre coincidem com o diretório escolhido pela CLI. Para instalações no projeto com skills 1.7.4, o mapeamento relevante é:

Agente	Valor após -a	Destino da instalação no projeto	Como invocar o router explicitamente no chat
Claude Code	claude-code	.claude/skills/	/router
Codex CLI ou extensão para IDE	codex	.agents/skills/	Selecione router em /skills ou mencione $router
Cursor Agent	cursor	.agents/skills/	Digite / e selecione router

Essas invocações devem ser feitas no chat do agente, não no Bash. O Cursor também aceita .cursor/skills/ para instalação manual, portanto a página resumida de instalação do pacote continua útil como referência de compatibilidade; um diretório .cursor/skills/ vazio não significa que a instalação pela CLI falhou.

O mapeamento atual de agentes no instalador direciona tanto o Codex quanto o Cursor para .agents/skills/. Quando há apenas um diretório de destino, ele recebe cópias dos arquivos. Se você selecionar clientes com destinos diferentes, o instalador poderá compartilhar uma cópia principal em .agents/skills/ por meio de links simbólicos ou criar cópias separadas. Leia o resumo da instalação para saber qual método foi usado.

Cada skill instalada deve seguir o formato <skills-directory>/<skill-name>/SKILL.md. Por exemplo, a skill de movimento no Codex fica em .agents/skills/godot-2d-movement/SKILL.md; no Claude Code, a entrada correspondente é .claude/skills/godot-2d-movement/SKILL.md. Preserve os diretórios references/, scripts/ e assets/ incluídos na skill, quando existirem, conforme as instruções de instalação manual.

Como o router evita carregar todas as skills?

O router seleciona instruções conforme o motor e a tarefa; o agente que o executa fornece o mecanismo de carregamento sob demanda. A visão geral da especificação Agent Skills descreve a descoberta por nomes e descrições, a ativação pela leitura do corpo da skill e a execução com recursos adicionais quando necessário.

As instruções do router aplicam esse mecanismo ao desenvolvimento de jogos:

1. Identificar um motor no projeto e ler sua versão.
2. Selecionar o menor conjunto pertinente de skills para o motor, a área, o gênero e o fluxo de trabalho.
3. Ler o conteúdo dessas skills e abrir as referências incluídas apenas quando a tarefa exigir.

No Godot, o principal arquivo de identificação é project.godot. No Unity, é a combinação de Assets/ com ProjectSettings/ProjectVersion.txt. Um pedido de movimentação pode selecionar godot-2d-movement e platformer; um pedido posterior para salvar dados deve selecionar as orientações de persistência pertinentes, sem carregar catálogos de motores que não têm relação com a tarefa.

O próprio router é um roteiro de instruções em SKILL.md seguido pelo modelo. Ele não é um executável separado que imponha um número máximo de leituras. Instalar apenas o router também não fornece as instruções especializadas às quais ele se refere: essas skills precisam estar instaladas e disponíveis para descoberta pelo agente.

Os metadados ainda ocupam contexto, e as instruções carregadas, os resultados de ferramentas e as novas tentativas continuam contando para o consumo do modelo. Se sua coleção de skills gerar avisos sobre o limite de descoberta, use --skill para instalar uma seleção menor que inclua o router e as especialistas necessárias ao trabalho. Não há um percentual medido de economia de tokens que possa ser deduzido apenas da quantidade de skills.

Valide uma tarefa pequena no motor de jogo

Confira tanto o carregamento das instruções quanto o comportamento resultante no motor. Inicie uma nova sessão do agente no projeto, selecione explicitamente o router conforme a tabela acima e use um dos prompts a seguir.

Se o cliente exibir a atividade das ferramentas, confirme a ativação da skill ou a leitura dos arquivos. Uma frase afirmando que a skill foi carregada é uma evidência mais fraca do que uma leitura bem-sucedida do SKILL.md instalado.

Godot: adicione um salto extra no ar

Use uma cena que já rode em um projeto Godot 4, com um personagem CharacterBody2D, uma forma de colisão e um chão. O router documenta a combinação de godot-2d-movement com platformer para esse pedido; a skill de movimento fornece as orientações para o controlador específicas do motor.

Use the installed router skill for this Godot project. Inspect project.godot
and the actual editor version before editing, and preserve that version.

Report the resolved paths of the router and selected SKILL.md files you
actually read. Resolve skill names through the installed skill locations.

Add one extra mid-air jump to the existing CharacterBody2D player.
Keep the change in the player controller and preserve the current controls.
A fresh jump press on the ground starts the first jump. One more fresh
press in the air starts the second. A third press before landing does
nothing. Holding the button must not repeatedly jump. Landing restores
both jumps.

List the changed files and give the exact scene and controls for checking
the result. Separate checks you ran from checks I must perform in Godot.

Execute a cena indicada. Dois acionamentos separados devem produzir dois saltos; um terceiro acionamento no ar não deve iniciar outro salto, e tocar o chão deve restaurar a sequência. Também mantenha o botão pressionado durante um salto para verificar se ele não dispara repetidamente e confira se surgiram erros de script ou de execução.

A skill de movimento usa Godot 4.7 como referência, mas as instruções de detecção do motor orientam preservar a versão de um projeto existente. Instalar o pacote não é motivo para migrar o projeto nem para substituir APIs pelas de outra versão.

Unity: separe os dados compartilhados das quantidades em execução

Use uma cena de teste que possa descartar em um projeto Unity existente. Esta verificação exercita unity-scriptableobjects; unity-csharp-scripting é pertinente ao pequeno componente que utiliza os dados. O teste verifica as orientações da skill para dados compartilhados sem pedir um sistema de inventário completo.

Use the installed router skill for this Unity project. Read
ProjectSettings/ProjectVersion.txt and preserve the editor and package
versions. Report the resolved SKILL.md paths you actually read.

Create an ItemDefinition ScriptableObject with itemId, displayName,
and maxStack, using CreateAssetMenu. Use one example asset with
itemId "potion", displayName "Potion", and maxStack 10. Treat the asset
as read-only configuration during play.

Create two distinct runtime slot instances referencing that same asset.
Start their quantities at 2 and 5. Add one small probe component that
decrements only the first slot, then reports quantities 1 and 5,
confirms both slots reference the same asset, and checks that the
definition fields are unchanged. Start each probe run with fresh slots.

Keep the output to the data model and probe component. Give exact
asset-creation, component-attachment, Inspector-assignment, and Play-mode
steps. Distinguish checks you executed from checks I must perform.

Crie o asset de exemplo pela entrada gerada no menu Assets, anexe o componente de verificação a um GameObject vazio, atribua o asset no Inspector e entre no modo Play. O resultado observável deve mostrar as quantidades independentes passando de 2 e 5 para 1 e 5, enquanto os dois slots mantêm a referência à mesma definição. Ao sair do modo Play, o asset ainda deve conter potion, Potion e 10.

A documentação de ScriptableObject do Unity explica que os objetos que usam esses dados podem compartilhar um asset por referência. O asset não é imutável por natureza; este exemplo mantém deliberadamente as quantidades que mudam em objetos separados durante a execução. Se as duas quantidades mudarem juntas, confira se a implementação está compartilhando por engano o objeto do slot, além da definição.

O que verificar se o agente não encontrar o router ou a skill escolhida?

Verifique separadamente a instalação, a descoberta e a resolução dos caminhos dos arquivos. Escolha a próxima ação de acordo com o sintoma:

Sintoma	Verificação e próxima ação
A prévia falha antes de listar as skills	Leia o erro apresentado; confira a versão ativa do Node.js, a disponibilidade do Git e o acesso ao npm/GitHub. Corrija o pré-requisito que falhou e execute --list novamente.
A lista de instaladas contém skills do motor, mas não router	Execute a instalação novamente e inclua router. Copiar manualmente apenas o conteúdo de skills/ do repositório deixa de fora o diretório separado router/.
Os arquivos existem, mas o agente não oferece as skills	Confirme que a sessão está no projeto desejado e que cada pasta contém SKILL.md. Confira os caminhos documentados pelo cliente e reinicie a sessão se a descoberta ainda não tiver sido atualizada.
O agente não consegue abrir um caminho que começa com skills/godot/ ou skills/unity/	Localize a skill pelo nome em seu diretório de instalação e confirme uma leitura bem-sucedida antes de editar.
O agente seleciona o motor errado	Abra o subdiretório correto do jogo ou informe explicitamente o motor e o projeto desejados; confira os arquivos usados para identificação e a versão informada pelo agente.

O caso de resolução de caminhos merece atenção: o router descreve os arquivos de origem como skills/<category>/<name>/SKILL.md, enquanto o instalador da CLI instala os diretórios individuais das skills com seus respectivos nomes. Um agente que siga literalmente o caminho relativo ao repositório de origem pode não encontrar uma skill instalada. Essa diferença entre estruturas é um ponto a verificar, não uma evidência de falha em todos os clientes.

Em uma instalação para Codex ou Cursor, uma skill de Godot selecionada pode, portanto, estar em .agents/skills/godot-2d-movement/SKILL.md, com suas próprias referências ao lado. Use o caminho encontrado, sem criar dentro do jogo uma segunda árvore que reproduza a estrutura do repositório.

Revise as skills de terceiros antes de reutilizá-las

Trate esses arquivos como instruções capazes de influenciar as edições e a execução de comandos pelo agente. Antes do primeiro uso, leia o router, o conteúdo das skills selecionadas, as referências necessárias e os scripts ou comandos externos que elas peçam ao agente para executar. Confira se a instalação de dependências, os destinos de downloads, os uploads e as operações destrutivas correspondem à tarefa que você solicitou.

A prévia com --list evita instalar o pacote de skills, mas npx ainda executa o instalador. Mantenha suas aprovações habituais para comandos e confira no resumo da instalação quais skills existentes seriam sobrescritas.

Ao adotar atualizações, revise também o frontmatter, o bloco de metadados no início do arquivo. Por exemplo, a documentação de allowed-tools do Claude Code explica que esse campo pode pré-aprovar o uso de ferramentas; ele não funciona como uma restrição de sandbox. Revise as instruções alteradas e os comandos incluídos mesmo quando o frontmatter for mínimo.

Mantenha a primeira alteração pequena o suficiente para revisar em um diff. Depois de adotar uma atualização de skill, repita a verificação pertinente no motor antes de depender dela para uma funcionalidade maior.