> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gennia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Conjuntos de instruções especializadas que o agente consulta conforme necessário

Skills são pastas com instruções que estendem as capacidades do agente. Em vez de colocar tudo no prompt principal, você organiza conhecimento especializado em skills que o agente consulta **sob demanda** — apenas quando encontra uma situação relevante.

## Como funciona

Skills usam um modelo de **descoberta progressiva** para manter o agente eficiente:

<Steps>
  <Step title="Descoberta">
    O agente carrega apenas o nome e a descrição de cada skill vinculada — o suficiente para saber quando ela pode ser útil.
  </Step>

  <Step title="Ativação">
    Quando uma conversa se encaixa na descrição de uma skill, o agente carrega as instruções completas.
  </Step>

  <Step title="Execução">
    O agente segue as instruções da skill, aplicando o conhecimento especializado na resposta.
  </Step>
</Steps>

Isso permite que o agente tenha acesso a muito mais conhecimento sem sobrecarregar o contexto a cada interação.

## O que colocar em uma skill

Uma skill é composta por instruções em texto que ensinam o agente a lidar com um cenário específico. Boas skills incluem:

* **Quando usar** — Em quais situações o agente deve ativar essa skill
* **Passo a passo** — Instruções claras do procedimento a seguir
* **Regras** — O que fazer e o que não fazer nesse cenário
* **Exemplos** — Modelos de resposta para guiar o agente

## Exemplos de skills

| Skill                     | O que faz                                                              |
| ------------------------- | ---------------------------------------------------------------------- |
| **Procedimento de troca** | Instruções passo a passo de como processar uma troca de produto        |
| **Escalação para humano** | Regras de quando e como transferir a conversa para um atendente        |
| **Qualificação de lead**  | Perguntas que o agente deve fazer para qualificar um potencial cliente |
| **Onboarding de cliente** | Fluxo de boas-vindas e configuração inicial para novos clientes        |
| **Política de reembolso** | Regras e condições para aprovar ou negar reembolsos                    |

## Criando e vinculando skills

### Criando na biblioteca

Skills são criadas na biblioteca do workspace (seção **Skills** no menu lateral). Cada skill criada fica disponível para ser vinculada a qualquer agente do workspace.

### Vinculando a um agente

Na seção **Skills** do agente:

* O painel principal mostra as skills já vinculadas ao agente
* A barra lateral direita mostra a **biblioteca de skills** disponíveis no workspace
* Clique em **Conectar** para vincular uma skill
* Clique em **Desconectar** para remover

<Tip>
  Skills são reutilizáveis — você pode vincular a mesma skill a vários agentes diferentes. Atualize a skill uma vez e todos os agentes vinculados recebem a versão atualizada.
</Tip>

## Skill vs. Prompt

|                    | Prompt                        | Skill                              |
| ------------------ | ----------------------------- | ---------------------------------- |
| **Quando é usado** | Sempre, em toda interação     | Sob demanda, quando relevante      |
| **Escopo**         | Comportamento geral do agente | Procedimento específico            |
| **Compartilhável** | Não                           | Sim, entre agentes                 |
| **Contexto**       | Sempre no contexto            | Carregado apenas quando necessário |

Use o **prompt** para definir o comportamento geral (papel, tom, regras básicas) e **skills** para procedimentos especializados que o agente ativa apenas em situações pontuais. Isso mantém o prompt enxuto e o agente mais eficiente.