# Como trabalhar com skills

> Adicione uma skill do catálogo ou escreva a sua, edite, recupere versões, coloque em projetos e escolha quais skills ficam ligadas.

Source: https://endless.okinawa/pt/docs/automate/skills

Uma skill é um conjunto de instruções que o Endless carrega quando uma tarefa precisa. Esta página
explica como adicionar, editar e ligar skills. Para entender o que é uma skill, veja [skills e
conhecimento](/pt/docs/concepts/skills-and-knowledge).

**Skills** na barra lateral lista todas as skills que você pode abrir: as suas, as compartilhadas
com você ou com o espaço de trabalho, e as integradas. Cada linha mostra a origem (**Integrada**,
**Do workspace** ou **Comunidade**), o acesso, a descrição e o seu interruptor. Busque pelo nome
ou filtre por criador, acesso, projeto e **Origem**.

<ImageZoom src="https://static.endless.software/docs/screenshots/skills-list-0bc24b3c.webp" alt="A página de Skills: um banner que convida a explorar o catálogo com três livros de skills em leque à direita, uma barra de filtros e busca, e a lista de skills, cada uma com nome, origem, descrição, quem criou, última atualização e um interruptor; uma linha está desligada e uma integrada aparece desativada para o espaço de trabalho" width="1280" height="720" />

## Adicionar uma do catálogo

<Steps>
  <Step>
    ### Abra o catálogo

    **"Explorar skills"** na página de Skills abre skills feitas pelo Endless ou adaptadas da
    comunidade, agrupadas por categoria.
  </Step>

  <Step>
    ### Abra uma ficha

    Ela mostra o que a skill faz, quem fez, quantas vezes foi usada e os arquivos que vêm dentro.
  </Step>

  <Step>
    ### Adicione

    **"Adicionar às minhas skills"*&#x2A; copia a skill para o seu espaço de trabalho como uma skill
    privada que você pode editar, compartilhar e colocar em projetos. Ou escolha um exemplo em
    &#x2A;*"Experimente"**: ele adiciona a skill e abre um chat novo com a mensagem escrita, sem enviar.
  </Step>
</Steps>

<ImageZoom src="https://static.endless.software/docs/screenshots/skills-explore-fc4762b9.webp" alt="O catálogo de skills: abas de categorias de Todas a Design acima de uma grade de fichas, cada uma desenhada como a capa colorida de um livro ao lado do título, resumo, autor e número de usos; a primeira está marcada como adicionada" width="1280" height="720" />

A sua cópia não muda sozinha. Quando o catálogo tem uma versão mais nova, a página da skill mostra
um botão &#x2A;*"Atualizar"**; as instruções anteriores ficam no histórico. Cada pessoa pode ter uma
cópia de cada ficha.

## Escrever a sua

**"Nova skill"** oferece:

| Caminho                | Entrada                                                                                                             |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Enviar**             | Um pacote `.zip` ou `.skill`, ou um único `SKILL.md`. Arquivos binários ou grandes demais são pulados e contados.   |
| **Colar**              | O texto do `SKILL.md`. Nome e descrição são lidos do frontmatter.                                                   |
| **De uma URL**         | Uma URL do skills.sh ou do GitHub. **Buscar**, confira o que carregou e adicione.                                   |
| **Criar com o agente** | Pela seta ao lado de &#x2A;*"Nova skill"**, ou peça em qualquer chat. O Endless escreve e salva quando você aprova. |

Você também pode escolher &#x2A;*"Criar skill"** no menu de uma das suas próprias mensagens no chat.
Todos os caminhos terminam com uma revisão de **Nome**, **Descrição*&#x2A; e acesso antes de &#x2A;*"Criar
skill"**.

<Callout type="warn">
  O Endless lê a descrição em cada mensagem para decidir quando carregar a
  skill. Escreva quando usar a skill, em menos de 1.000 caracteres.
</Callout>

Adicionar ou criar uma skill exige permissão para criar conteúdo (membros e admins por padrão,
visualizadores não). Uma skill nova fica **Privada** até você compartilhar. O `SKILL.md` tem
limite de 64KB; coloque material de referência longo em um arquivo separado, que o Endless lê só
quando precisa.

## Editar uma skill

Abra uma skill para ver a descrição, quem criou, os projetos, o status e a árvore de arquivos.
Edite um arquivo e salve com **⌘S** (**Ctrl+S**). **Compartilhar** e **Histórico** ficam no
cabeçalho.

<ImageZoom
  src="https://static.endless.software/docs/screenshots/skills-db4bc8cf.webp"
  alt="
  'Uma skill chamada &#x22;Brand voice&#x22; aberta na própria página: a árvore de arquivos à esquerda com SKILL.md, uma pasta de referências e uma de scripts; à direita a descrição, quem criou, o projeto em que está e um interruptor ligado acima de uma prévia do SKILL.md; Histórico e Compartilhar ficam no cabeçalho'
"
  width="1280"
  height="720"
/>

* Quem criou edita, compartilha e exclui. Pessoas com **Pode editar** podem editar; só quem criou
  muda o compartilhamento. Skills integradas não podem ser editadas, excluídas nem compartilhadas.
  Permissões sobre conteúdo de outras pessoas: [funções e
  permissões](/pt/docs/governance/roles-and-permissions).
* Quando o Endless quer alterar uma skill durante um chat, mostra um cartão para você aprovar ou
  descartar. Se você não pode editar a skill, ele diz que a alteração não foi salva.
* **Histórico*&#x2A; guarda cada versão, a primeira e as últimas 100. &#x2A;*"Restaurar"** adiciona a versão
  antiga como uma nova.
* **Excluir** move a skill para **Configurações → Lixeira** por 30 dias; depois ela é excluída de
  vez. Quem podia excluí-la pode restaurá-la. Uma cópia do catálogo não pode ser restaurada
  enquanto você tiver uma cópia mais nova da mesma ficha.

## Ligar e desligar skills

Dois interruptores valem, e o do espaço de trabalho prevalece:

| Nível              | Onde                                                   | Efeito                                                                             |
| ------------------ | ------------------------------------------------------ | ---------------------------------------------------------------------------------- |
| Pessoal            | O interruptor de cada linha na página de Skills        | Liga ou desliga só para você                                                       |
| Espaço de trabalho | **Configurações → Governança → Skills**                | Desligar remove para todos; ligar só deixa disponível                              |
| Membro             | O perfil de um membro em **Membros**, aba **Recursos** | Ajusta a skill de uma pessoa; antes ela precisa estar ligada no espaço de trabalho |

Onde o espaço de trabalho desligou uma skill, o seu interruptor mostra o selo bloqueado
&#x2A;*"Desativado para o espaço de trabalho"**. Mudar os níveis de espaço de trabalho e de membro
exige a permissão de governança (admins por padrão). Veja [funções e
permissões](/pt/docs/governance/roles-and-permissions).

Uma skill desligada não carrega em lugar nenhum: chat, projetos ou execuções agendadas.

## Skills em projetos

A aba **Conhecimento*&#x2A; de um projeto lista as skills colocadas ali: &#x2A;*"Adicionar skill"*&#x2A; coloca
uma existente, &#x2A;*"Nova skill"** escreve uma no projeto. Todos que podem abrir o projeto podem ler
e usar uma skill colocada nele. É a mesma skill em todos os lugares onde está.

Uma skill colocada em um projeto carrega nos chats com esse projeto anexado; em outros lugares,
só quando você a chama com `/`. Ela continua obedecendo aos interruptores. O conhecimento próprio
de um projeto não tem interruptor e sempre carrega com o projeto. Veja
[projetos](/pt/docs/concepts/projects).

## Usar skills

* **No chat**: uma skill ligada carrega quando uma tarefa corresponde a ela. Digite `/` no
  compositor para chamá-la pelo nome.
* **Em [tarefas agendadas](/pt/docs/automate/scheduled-tasks)*&#x2A;: skills também carregam nas execuções. O
  controle &#x2A;*"Conectores e skills"** de um agendamento pode desligar skills só para aquele
  agendamento.

Relacionado: os [conectores](/pt/docs/automate/connectors) dão ao Endless acesso a ferramentas externas.