# Skills

Entenda as instruções reutilizáveis do Maestro e confira catálogo, origem e limites antes de usar.

Fonte: https://guides.adapta.org/guias/maestro/recursos-do-maestro/skills/

**TL;DR** · Skills são instruções reutilizáveis para orientar um tipo de trabalho. Abra **Skills** na lateral para consultar o catálogo.

![Gravação do Maestro: a lateral abre a página Skills, com as abas Skills e Ferramentas, o campo de busca e o contador de skills ativas; a rolagem desce pelos cartões até a seção Biblioteca, onde cada item tem o botão Instalar.](https://guides.adapta.org/media/screenshots/maestro/skills-usar-2026-09-19/maestro-skills-catalogo-fluxo.gif)

*O catálogo em uma tela: o que já está ativo em cima, a Biblioteca embaixo. Consultar não instala nada.*

## O que muda no trabalho

Pense em uma Skill como um roteiro de revisão. O roteiro define como conferir uma proposta; os valores, prazos e condições de cada proposta chegam no pedido. Assim, método e dados não precisam ser misturados em uma instrução permanente.

A página do Maestro descreve Skills como instruções que o agente aplica quando a tarefa pede. Essa é a finalidade apresentada pelo produto. Este guia cobre a consulta ao catálogo; a escolha automática e a execução de uma Skill específica ainda não têm verificação registrada.

## O que você encontra

A página tem duas abas: **Skills** e **Ferramentas**. Na primeira, aparecem um campo de busca, **Instalar via URL**, **Criar skill**, uma lista de recursos ativos e uma **Biblioteca**. Itens podem apresentar **Desabilitar skill**, **Editar skill** e, em alguns casos, **Remover skill**. Na Biblioteca, você encontra **Instalar**.

![Aba Skills, com busca, Instalar via URL, Criar skill e a lista de recursos ativos (27 skills), cada um com um interruptor e um ícone de edição, alguns também com um ícone de remover.](https://guides.adapta.org/media/screenshots/maestro/skills-2026-09-10/skills-lista.png)

Não reproduzimos os nomes e instruções particulares da conta. O catálogo pode mudar conforme o assistente e seu acesso. Um item na Biblioteca não deve ser interpretado como já instalado; um controle ativo não prova participação em determinada resposta.

## Skill não é ferramenta, assistente ou conector

|  Recurso |  Papel na tarefa |
| --- | --- |

|  Skill |  Orienta um método de trabalho por meio de instruções reutilizáveis. |

|  Ferramenta |  Oferece uma capacidade de ação. Sua disponibilidade e permissão precisam ser conferidas separadamente. |

|  Assistente |  É o perfil com o qual você trabalha; o formulário de nova Skill fica vinculado a um assistente. Isso não prova alcance global. |

|  Conector |  Relaciona o trabalho a um serviço externo. Ter uma instrução que menciona esse serviço não comprova conexão nem autorização. |

Consulte [Ferramentas](https://guides.adapta.org/guias/maestro/recursos-do-maestro/ferramentas/), [Assistentes](https://guides.adapta.org/guias/maestro/recursos-do-maestro/assistentes/) e [Conectores](https://guides.adapta.org/guias/maestro/recursos-do-maestro/conectores/) para não confundir esses papéis.

## Como o cadastro apresenta as instruções

**Criar skill** abre **Nova skill**, com **Nome**, **Descrição** e **Corpo do SKILL.md**. O corpo inicial traz seções **Quando usar** e **Passos**, além dos modos **Escrever** e **Prévia**. SKILL.md é o nome do documento de instruções apresentado nesse editor, não uma credencial ou um conector.

A interface informa que o nome é obrigatório e destaca a descrição como critério de escolha. Trate a descrição como uma explicação concreta de quando aplicar o método. O aviso da interface não substitui um teste do carregamento e da seleção pelo agente.

![Editor Nova skill com os campos Nome e Descrição vazios (ambos com aviso de obrigatoriedade) e o corpo do SKILL.md com as seções Quando usar e Passos preenchidas com o modelo padrão.](https://guides.adapta.org/media/screenshots/maestro/skills-2026-09-10/nova-skill-editor.png)

Ao sair do formulário sem preencher nada, o Maestro pergunta **Sair sem salvar?**; **Descartar e sair** encerra somente esse rascunho vazio. Não use essa opção se houver trabalho que você queira preservar.

**Dica prática:** dê uma função central à instrução. A aula 4 de Como Criar Assistentes de IA, “A Anatomia de um Expert de Alta Performance”, organiza propósito, regras, insumos e formato. Aplicamos esse método à preparação de Skills, sem afirmar que Expert e Skill sejam o mesmo recurso.

## Prepare antes de executar

- [Escolha uma Skill para o trabalho](https://guides.adapta.org/guias/maestro/recursos-do-maestro/skills/usar/): confira finalidade, origem e fronteiras de ação.

- [Prepare o teste de uma Skill](https://guides.adapta.org/guias/maestro/recursos-do-maestro/skills/testar/): use uma entrada sintética com gabarito e conflito controlado.

Instalação, ativação, edição, salvamento e execução exigem sua própria verificação. Não coloque senhas ou tokens no corpo da Skill. Solicitações de enviar mensagens, alterar registros ou instalar recursos exigem autorização própria, mesmo quando aparecem nas instruções.

Explore aplicações nos [casos de uso do Maestro](https://guides.adapta.org/guias/casos-de-uso/por-plataforma/maestro/).