---
title: Criar, Importar e Gerenciar Habilidades
description: Crie uma Habilidade personalizada, importe uma Habilidade compatível e edite ou exclua-a com segurança mais tarde.
---

Habilidades personalizadas permitem que você empacote suas próprias instruções para uso repetido. Importar é útil quando uma Habilidade compatível já existe e você quer revisá-la antes de adicioná-la ao Runner.

![Ferramentas do Agente do Runner](https://ixft9x6szo.ufs.sh/f/Cc8uxBgAYTzgMN6p3Ta4kBHzfjRG8M5Ywdv1hEVDJx43X2bU)

## O que este guia cobre

Você saberá como criar ou importar uma Habilidade, entender cada controle do editor e distinguir pausa reversível de exclusão permanente.

## Disponibilidade e pré-requisitos

- Abra um projeto com acesso a **Agent → Habilidades**.
- Habilidades exigem acesso ao plano.
- Importar exige uma URL de fonte compatível que o Runner possa ler.
- Não importe instruções em que você não confia. Revise o nome, descrição, conteúdo, configurações e arquivos inclusos antes de salvar.

## Caminhos de entrada

- Criar: **Centro de controle → Agente → Habilidades → Descobrir → Criar habilidade**
- Importar: **Centro de controle → Agente → Habilidades → Descobrir → Importar**
- Editar ou excluir: **Centro de controle → Agente → Habilidades → Adicionadas → Mais ações**

## Controles do editor de Habilidade

| Entrada ou botão | Por que é útil | O que acontece a seguir |
| --- | --- | --- |
| **Nome** | Dá à Habilidade sua identidade em listas e comandos. | O Runner valida que um nome está presente antes de salvar. |
| **Descrição** | Explica quando a Habilidade deve ser usada. | A descrição aparece em listas e seletores de Habilidade. |
| **Conteúdo** | Armazena as instruções reutilizáveis. | O Runner usa este conteúdo quando a Habilidade é invocada. |
| **Categoria** | Agrupa Habilidades relacionadas. | Este rótulo opcional afeta como as Habilidades são organizadas. |
| **Rótulo de Atalho** | Dá à Habilidade um rótulo de comando mais claro. | O rótulo opcional aparece com controles orientados por comando. |
| **Ativado** | Escolhe se a Habilidade nova ou editada inicia ativa. | Desativá-la salva a Habilidade em estado pausado. |
| **Desabilitar Invocação Automática de IA** | Impede que o Runner escolha a Habilidade automaticamente. | A Habilidade permanece disponível para uso manual. |
| **Invocável pelo Usuário** | Permite uso manual de comando de barra. | Desativá-lo remove a invocação manual mantendo outro uso permitido. |
| **Dica de Argumento** | Mostra a entrada esperada após um comando. | A dica pode exibir exemplos como uma URL ou número de problema. |
| Área de arquivos | Adicione texto de suporte ou ativos necessários pela Habilidade. | O Runner valida limites de arquivo individual e total antes de salvar. |
| **Cancelar** | Saia sem aplicar a edição atual. | O diálogo fecha; as alterações não salvas são descartadas. |
| Ação salvar/criar | Persista uma Habilidade válida. | O Runner fecha o editor após o sucesso e atualiza a lista de Habilidades. |

## Crie uma Habilidade personalizada

1. Abra **Agent → Habilidades**.
2. Em **Discover**, selecione **Criar habilidade**.
3. Digite um **Nome** válido, uma **Descrição** concisa e o **Conteúdo** da Habilidade. Esses campos são obrigatórios.
4. Adicione uma categoria, rótulo de atalho, dica de argumento ou arquivos de suporte apenas quando tornarem a Habilidade mais fácil de usar.
5. Revise **Ativado**, **Desabilitar Invocação Automática de IA** e **Invocável pelo Usuário**. Esses controles alteram como o Runner pode usar a Habilidade.
6. Selecione a ação salvar/criar.
7. Confirme que a Habilidade aparece em **Adicionado** ou **Pausado**, dependendo da configuração Ativado.

## Importe uma Habilidade

1. Em **Agent → Habilidades → Discover**, selecione **Importar**.
2. Cole a URL de fonte compatível.
3. Selecione **Importar**.
4. Para uma Habilidade descoberta, o Runner abre o editor com campos importados preenchidos. Para uma fonte contendo várias Habilidades, o Runner abre um seletor.
5. Revise cada campo importado e qualquer aviso de arquivo excluído ou tamanho.
6. Faça as alterações necessárias e salve.
7. Confirme que a Habilidade aparece na página do Agent antes de fechar seu fluxo de trabalho.

Importar não torna conteúdo não revisado confiável. Trate instruções importadas como qualquer outro conteúdo que possa influenciar o trabalho do Runner.

## Editar, pausar ou excluir

1. Selecione uma linha de Habilidade Personalizada ou abra **Mais ações → Editar**.
2. Altere os campos que você precisa e salve.
3. Para parar de usá-la sem perdê-la, selecione **Adicionado** para movê-la para **Pausado**.
4. Para removê-la, abra **Mais ações → Excluir**.
5. Revise o diálogo de confirmação nomeado e selecione **Delete** apenas quando você pretender remover a Habilidade.

**Excluir é destrutivo.** Não é o mesmo que pausar, e a página não o apresenta como uma ação desfeita. System Habilidades não oferecem exclusão.

## Estados e limites

- Nome, Descrição ou Conteúdo ausentes bloqueiam o salvamento e mostram uma mensagem de validação.
- Um nome de Habilidade importada duplicado pode ser rejeitado ou marcado como já presente.
- Arquivos que excedem limites aceitos podem ser ignorados; um aviso de tamanho total pode bloquear o salvamento até que o conteúdo seja reduzido.
- Enquanto salvamento, importação ou exclusão está em execução, aguarde a mensagem de sucesso ou erro antes de tomar outra ação.
- Ver Habilidades de Sistema apenas podem mostrar detalhes mas não expõem controles de edição de Habilidade Personalizada.

## Solução de problemas

- Se **Importar** permanecer indisponível, aguarde a verificação de Habilidade existente ser concluída e confirme que o campo URL não está vazio.
- Se a importação abrir um seletor em lote, selecione apenas as Habilidades que você reconhece e precisa.
- Se o salvamento estiver bloqueado, verifique os campos obrigatórios e qualquer aviso de arquivo no topo do editor.
- Se uma Habilidade desapareceu após selecionar **Adicionado**, verifique **Pausado** antes de recriá-la.
- Se a exclusão falhar, a Habilidade permanece; feche o erro e tente novamente após verificar suas permissões.

## Guias relacionadas

- [Habilidades](./skills)
- [Visão geral de Customização do Agent](./)
- [Use a paleta de comandos do Agent](./command-palette)
- [Armazene configurações do Agent](../account-and-settings/custom-scripts-and-store-agent)