Skills personalizadas

Transforme uma rotina que você repete em uma ferramenta sua. Uma skill personalizada funciona como uma nativa. Qualquer agente no seu computador pode encontrá-la, carregá-la e chamá-la no seu app.


Visão geral

Cada conector oferece suas ferramentas em skills, como cena, importação e materiais. Você pode adicionar as suas próprias ao lado delas, por exemplo um relatório de cena, uma regra da casa para importações, ou uma renomeação em lote. Uma skill é uma pasta com três partes:

  • Um SKILL.md que a descreve.
  • Um tools.yaml que lista suas ferramentas.
  • Os scripts que são executados dentro do app.

Skills personalizadas funcionam no Blender. A página Skills da janela Meshy DCC Core mostra cada skill, de onde ela vem e qual app aberto a carregou.

Página Skills da janela Meshy DCC Core, com as skills que cada instância conectada do Godot e do Blender carregou, incluindo a skill personalizada my-scene-report


Peça ao seu agente para escrever uma

A skill Meshy DCC inclui um guia para escrever skills, de modo que seu agente possa escrever uma para você. Descreva a rotina, por exemplo:

  • Escreva uma skill do Blender que conte os objetos na cena aberta por tipo.
  • Adicione uma ferramenta à minha skill scene-report que lista malhas com mais de 50.000 polígonos.

O agente escreve os arquivos na sua pasta de skills, verifica-os, recarrega os apps abertos e testa a nova ferramenta. Para copiar um prompt pronto, vá até My skills na página Skills.

Seção My skills da página Skills, com uma skill personalizada chamada my-scene-report marcada como In use na pasta padrão do Blender, uma pasta padrão vazia do Godot, e um prompt para que seu agente escreva uma


Sua pasta de skills

A tabela a seguir mostra a pasta que cada app lê.

AppPasta
Blender~/.meshy-dcc/blender/skills/

Nomeie cada pasta de skill com palavras em minúsculas unidas por hífens, e comece com my- ou o prefixo do seu estúdio, como my-scene-report. Não reutilize o nome de uma skill nativa. Se o fizer, o Meshy DCC Core usa a skill nativa e ignora sua cópia.

Para verificar uma skill antes de carregá-la, execute:

meshy-dcc lint ~/.meshy-dcc/blender/skills/my-scene-report

Carregar uma nova skill

Os apps abertos detectam skills novas e alteradas quando são recarregados. Para recarregá-los, vá até a página Skills e clique em Reload in open apps. Cada skill mostra um destes estados:

  • In use: carregada e pronta nos apps abertos.
  • Waiting for reload: no disco, ainda não carregada. Se uma skill permanecer nesse estado após uma recarga, ela tem um erro. Para ver o erro, execute meshy-dcc lint na sua pasta.
  • Same name as a built-in skill; rename it: a skill nativa prevalece. Dê à sua outro nome.
  • App not open: o app ao qual ela pertence não está em execução.

Skills que já estão carregadas permanecem carregadas entre recargas, e uma skill alterada é recarregada automaticamente.


Compartilhar skills com sua equipe

Para compartilhar skills com sua equipe, mantenha-as em uma pasta compartilhada. Na página Skills, insira o caminho completo da pasta e clique em Add folder. Os apps abertos a recarregam imediatamente, e suas skills aparecem para todos os agentes naquele computador.