# Skills e conhecimento

> Skills ensinam seus fluxos de trabalho ao Endless e só carregam quando uma tarefa precisa. De onde vêm, como ativá-las e o que é conhecimento.

Source: https://endless.okinawa/pt/docs/concepts/skills-and-knowledge

Uma **skill** é uma pasta com um `SKILL.md` dentro: um nome, uma descrição de quando usá-la e as
instruções que o Endless segue. Ela também pode trazer referências e scripts. Você escreve uma
vez, e o Endless a usa sempre que uma tarefa corresponde à descrição.

<ImageZoom src="https://static.endless.software/docs/screenshots/skills-db4bc8cf.webp" alt="Uma skill aberta na própria página: à esquerda a árvore de pastas, com SKILL.md ao lado de uma pasta references e uma pasta scripts; à direita a descrição da skill (quando o Endless deve usá-la) acima de uma prévia do próprio SKILL.md" width="1280" height="720" />

## Como uma skill carrega

1. No início, o Endless lê só o nome e a descrição de cada skill.
2. Quando uma tarefa corresponde, ele lê o `SKILL.md` completo.
3. Ele segue as instruções e carrega os arquivos incluídos conforme precisa.

Por isso instalar muitas skills não deixa o Endless mais lento, e a **descrição** decide se uma
skill é usada. Escreva-a como *quando usar isto*, não *o que é isto*.

## De onde vêm as skills

| Origem                  | Detalhes                                                                                                                                                                                                                                                                                           |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Incluídas               | Vêm instaladas em todo espaço de trabalho (documentos, apresentações, imagens, `clip` para cortar, reenquadrar e legendar vídeo). Podem ser desligadas, mas não editadas nem excluídas.                                                                                                            |
| Catálogo                | **"Explorar skills"**: skills feitas pelo Endless e adaptadas da comunidade. Adicionar uma a copia para o seu espaço de trabalho como sua. Veja [adicionar uma do catálogo](/pt/docs/automate/skills#adicionar-uma-do-catálogo).                                                                   |
| Escritas por você       | **"Nova skill"**: **Enviar** (um `.zip` ou um `SKILL.md`), **Colar** (o texto do `SKILL.md`) ou **De uma URL*&#x2A; (um link do skills.sh ou do GitHub, com os arquivos). &#x2A;*"Criar com o agente"** escreve uma com você em um chat. Também dá para transformar uma mensagem do chat em skill. |
| Conhecimento de projeto | A entrada de conhecimento de cada projeto é uma skill. Ela nunca aparece na lista de Skills e só carrega quando o projeto está anexado. Veja [Projetos](/pt/docs/concepts/projects).                                                                                                               |

As skills que você escreve ou adiciona são **privadas** até você compartilhá-las com pessoas ou
com o espaço de trabalho, podem ser arquivadas em projetos (todos que podem abrir o projeto podem
usá-las), guardam um **histórico** de onde você pode restaurar e vão para a **lixeira** por 30
dias quando excluídas. Veja [trabalhar com skills](/pt/docs/automate/skills).

## Ligar e desligar skills

| Nível              | Onde                                                                                 | Efeito                                                                                           |
| ------------------ | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| Espaço de trabalho | **Configurações → Governança → Skills** (permissão de governança, admins por padrão) | Desligada, some para todos. Ligada, apenas fica disponível.                                      |
| Pessoa             | Perfil da pessoa → **Recursos** (permissão de governança)                            | Define as skills de uma pessoa. A skill precisa estar ligada para o espaço de trabalho antes.    |
| A sua              | O interruptor em cada linha da página **Skills**                                     | Liga ou desliga para você uma skill disponível. Fica travado se o espaço de trabalho a desligou. |

Um admin também pode desligar **Skills** como um todo, para o espaço de trabalho, uma equipe ou uma
pessoa, em **Configurações → Governança → Ferramentas**. A página **Skills** e o menu `/` somem e
as skills da biblioteca param de carregar; as skills e o conhecimento próprios de um projeto
continuam carregando quando o projeto está anexado.

Uma skill desligada fica desligada em todo lugar, inclusive nas tarefas agendadas. Veja
[Funções e permissões](/pt/docs/governance/roles-and-permissions).

## Skills, conhecimento e conectores

| O quê            | Acrescenta                                             | Vale para                                                                                                    |
| ---------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| **Skill**        | Instruções e arquivos: um fluxo de trabalho a seguir   | Quem a tem compartilhada ou pode abrir um projeto em que ela está (as incluídas: todos), onde estiver ligada |
| **Conhecimento** | Fatos e regras duradouros sobre um cliente ou campanha | Os chats em que o projeto dele está anexado                                                                  |
| **Conector**     | Acesso a uma ferramenta externa, com suas credenciais  | Cada pessoa, dentro do que o espaço de trabalho permite. Não faz nada até você entrar na ferramenta.         |