> For the complete documentation index, see [llms.txt](https://docs.adapta.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adapta.org/inicio-rapido/skills.md).
# Skills
**Uma Skill é uma pasta que ensina ao Adapta One o seu trabalho, o seu método, a sua expertise, o seu domínio.**
Pensa no que você hoje explica toda vez que abre um chat novo.
Cada repetição representa tempo perdido e espaço para a IA cometer erros.\
\
A Skill resolve isso de forma definitiva: você ensina uma única vez e ela aplica sempre.
A Skill funciona como uma receita que você transmite à equipe.
Você cria, envia para quem precisar, e o conhecimento deixa de ficar concentrado em uma única pessoa.\
\
**A expertise se transforma em alavanca.** Uma pessoa competente passa a produzir como dez.
A partir desse momento, toda vez que a tarefa for solicitada, o resultado já sai dentro do seu padrão.
{% embed url="" %}
***
⏱️ Leitura: 6 min · 🛠️ Mão na massa: 2 min · 📊 Nível: Iniciante
**🎯 O que você vai levar desta página**
* Quando uma tarefa merece virar Skill
* Como criar sua primeira Skill em 2 minutos
* Os 5 elementos de uma Skill que funciona
* A diferença entre Skill, Expert e Contexto
* Como evoluir a Skill com o uso
***
### ⚡ Por que Skills mudam o seu jeito de trabalhar
Maior parte das pessoas usa IA como calculadora. Pergunta uma coisa, recebe uma resposta, esquece. Começa do zero todo chat novo.
Skill vira o jogo. A IA deixa de ser genérica para todo mundo e vira *a sua IA*, que entende a sua expertise, os seus clientes, o seu padrão de entrega.
#### 🧰 Sem Skill × Com Skill
{% tabs %}
{% tab title="Sem Skill (cada chat do zero)" %}
> Você: "Escreve a legenda do post do lançamento"
>
> IA: *\[gera legenda genérica com emoji e 5 linhas]*
>
> Você: "Não, sem emoji, máximo 3 linhas, CTA no final, tom mais seco"
>
> IA: *\[reescreve]*
>
> Você: "Agora sim"
> {% endtab %}
{% tab title="Com Skill (ela já sabe)" %}
> Você: "Escreve a legenda do post do lançamento"
>
> IA: *\[aplica Skill sozinho e devolve no seu padrão de primeira]*
> {% endtab %}
> {% endtabs %}
A diferença não é só tempo. É a sensação de ter uma IA que trabalha *com você* em vez de *para qualquer um*.
***
### 🔀 Skills, Experts e Contextos: quando usar cada um
O Adapta One tem três ferramentas parecidas, mas com papéis distintos. A diferença central está em **quem puxa o gatilho**: a Skill puxa sozinha, em segundo plano. O Expert e o Contexto esperam que você os escolha.
| Ferramenta | O que é | Ativação |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| **Skill** | Instrução salva que ensina ao Adapta One *como* executar uma tarefa recorrente no seu padrão. | **Automática, em segundo plano.** Enquanto estiver ativa, o Adapta One aplica sozinho sempre que o pedido corresponder ao caso de uso. |
| **Expert** | Especialista com personalidade, missão e instruções próprias, dedicado a um tema. | **Manual.** Você abre o chat do Expert antes de iniciar a conversa. |
| **Contexto** | Bloco de referência com informação fixa (dados do cliente, briefing, base de conhecimento, regras internas) que o Adapta One consulta durante a conversa. | **Manual.** Você ativa o Contexto ao chat quando precisar dele. |
**Regra prática:**
* Tarefa que se repete no seu padrão: **Skill**.
* Especialista dedicado a um tema: **Expert**.
* Informação de referência para consulta na conversa: **Contexto**.
***
### 🎯 Quando criar uma Skill
Se você responde **sim para pelo menos 2** dessas, vira Skill:
* Eu repito essa tarefa mais de uma vez por semana?
* Tem um padrão específico *meu* (tom, formato, critério) que a IA precisaria saber?
* Eu perderia tempo explicando isso para outra pessoa também?
* O resultado precisa sair consistente toda vez (para cliente, equipe, entregável)?
Se respondeu sim em pelo menos 2, você já tem material. Se não, é tarefa única e não compensa salvar.
{% embed url="" %}
{% hint style="info" %}
Se repete, vira Skill. Padrão de legenda, tom de voz, formato de relatório, critério de análise de documento. Tudo que você hoje explica toda vez pode ficar salvo de uma vez.
{% endhint %}
***
### 📋 Antes de começar
Você vai precisar de:
* Conta ativa no Adapta One
* Uma tarefa que você repete toda semana
* 2 ou 3 exemplos reais de como essa tarefa fica bem feita por você
***
### 🛠️ Como criar uma Skill
{% tabs %}
{% tab title="Jeito A: a partir do chat" %}
**Você acabou de fazer algo legal no chat**
Esse é o mais rápido. Depois de gerar aquele PDF, legenda, relatório ou resposta que ficou no seu estilo, peça no próprio chat:
> "Cria uma Skill com base no que a gente acabou de fazer."
O Adapta One monta a Skill pronta com título, descrição, instruções e exemplos. Você só revisa.
{% endtab %}
{% tab title="Jeito B: do zero com exemplos" %}
**Você tem a tarefa na cabeça, mas ainda não tem exemplo no chat**
Abra um chat novo, descreva a tarefa e cole 2-3 exemplos reais de como fica bom (e 1 ruim para mostrar o que evitar). Peça:
> "Transforma isso em uma Skill."
Mesmo resultado: Skill pronta, você revisa.
{% endtab %}
{% tab title="Jeito C: manual" %}
**Você já tem o texto pronto ou quer escrever do zero**
Abra o painel de **Skills** na barra do chat, clique em **+ Skill** e preencha na mão:
* **Título**: nome curto da Skill
* **Descrição**: 1 linha do que ela faz e quando ativar (é o que o agente lê para decidir)
* **Instruções**: o texto principal com regras, exemplos, formato de saída
Você pode escrever direto na caixa ou colar um texto que já tem salvo. Salva e pronto.
{% endtab %}
{% endtabs %}
{% hint style="success" %}
**Dica de ouro:** cole 3 exemplos bons e 1 ruim. É o que faz o Adapta One captar o seu padrão em vez de improvisar um genérico.
{% endhint %}
{% hint style="info" %}
**Se travou:** abra o [**Expert Criador de Skills** ](https://agent.adapta.one/expert/shared/019cb431-16ee-7972-b93b-45226ed08688)do Adapta One. Ele faz as perguntas certas e monta a Skill junto com você.
{% endhint %}
#### Revisar
Quando o Adapta One termina de montar a Skill (Jeito A ou B), ela já é **salva e ativada automaticamente**. Você não precisa clicar em Salvar.
Se quiser conferir ou ajustar, clique no botão **Skills** na barra do chat e abra a Skill recém-criada na aba **Pessoais**. O botão **Salvar** só aparece quando você edita alguma coisa.
Vale revisar principalmente o **título** e a **descrição**, porque é o que o agente usa para decidir quando ativar a Skill sozinho.
#### Evoluir a Skill com o uso
Skill não nasce pronta. Nasce boa e fica ótima com iteração.
Toda vez que você usa a Skill e percebe que ela errou algo, ou que poderia ter feito melhor, abra ela de novo (botão **Skills** → aba **Pessoais**) e ajuste na mão:
* Adicione o exemplo do output que deu certo hoje
* Adicione uma regra nova que apareceu ("nunca use gíria X", "sempre inclua Y")
Skill boa cresce junto com você. A cada 1 ou 2 semanas, olhe as Skills mais usadas e faça 1 ajuste pequeno. Em poucos meses você tem um arsenal que ninguém mais tem.
***
### 📚 A Biblioteca de Skills
O botão **Skills** na barra do chat abre a sua Biblioteca. Três abas:
* **Pessoais**: Skills que você criou
* **Adapta**: Skills prontas curadas pela Adapta
* **Empresa**: Skills compartilhadas pela sua empresa (B2B)
É só clicar **Copiar** no card para trazer a Skill para suas Pessoais.
#### Pastas para organizar
Dentro da aba **Pessoais** você pode criar **Pastas** para separar suas Skills por tema, cliente ou projeto. Clique em **+ Pasta**, dê um nome, e arraste as Skills para dentro.
Exemplos de pastas que funcionam bem:
* Por cliente (ex: Cliente X, Cliente Y)
* Por tipo de entrega (ex: Copy, Relatórios, Análises)
* Por projeto (ex: Lançamento Junho, Campanha Black Friday)
Pasta é só para organização visual.
***
### 🎮 Como usar no dia a dia
Tem 3 formas de disparar uma Skill.
**1. Deixar o agente identificar sozinho**
Cole o briefing e trabalhe normalmente. Se a Skill estiver ativa e o input bater com a descrição, o Adapta One aplica sozinho.
**2. Chamar pelo nome**
*"Usa a Skill de headline direto nesse briefing aqui."*
**3. Acionar pela cerquilha (`#`)**
Digite `#` no chat (a cerquilha, também chamada de hashtag) e aparecerá uma lista das suas Skills. Escolha clicando, ou continue digitando as primeiras letras (por exemplo, `#head`) para filtrar. Útil quando você quer garantir que uma Skill específica entre no jogo.
#### Ativar e desativar Skill
Cada Skill tem um botão de liga/desliga no card dentro da Biblioteca. É por ele que você controla quais Skills entram em jogo no chat.
* **Verde**: Skill ativa. O Adapta One pode aplicá-la sozinho quando o gatilho corresponder.
* **Cinza**: Skill desativada. Continua salva, mas volta a entrar em jogo apenas quando você ligá-la de novo.
***
### 🧩 Os 5 elementos de uma Skill que funciona
#### 1. Escopo cirúrgico
**Skill genérica = resultado genérico.** A regra é recortar a tarefa até sobrar uma coisa específica.
Se você pensa "quero uma Skill de marketing", o recorte ainda não aconteceu. Qual tarefa de marketing? Gerar headline? Reescrever copy de anúncio? Escrever legenda? Planejar conteúdo mensal? Cada uma dessas vira uma Skill diferente.
**Teste:** se você consegue descrever a Skill em uma frase no formato "verbo + objeto + estilo" (ex: "reescrever headline de anúncio no estilo direto"), o escopo está cirúrgico. Se precisa de duas frases para explicar, volta e recorta mais.
#### 2. Exemplos reais do seu padrão
**É o que faz a Skill soar como você, não como IA genérica.** Sem exemplo, a IA improvisa um padrão qualquer baseado em média da internet.
Cole 2-3 outputs bons (coisas que você aprovaria pro cliente sem hesitar) e 1 ruim, com a razão curta do que tornou ele ruim. O output ruim é tão importante quanto o bom, porque ensina a Skill o que evitar.
**Teste:** se os seus exemplos bons são intercambiáveis com exemplos que qualquer IA geraria, eles não são exemplos *seus*. Precisam ter algo de assinatura: corte de frase, vocabulário, ritmo, estrutura.
#### 3. Gatilho preciso
**A Skill precisa saber quando ativar sozinha.** Gatilho vago = Skill que você esquece que tem.
Transforma "em que momento eu uso isso?" em regra explícita. Em vez de "uso isso para copy", escreve:
> "Toda vez que eu colar um briefing de anúncio e pedir headline, ativa."
Gatilho bom responde duas perguntas: **qual input** chega (briefing, email, notas de call) e **qual pedido** do usuário dispara (copy, resumo, análise).
#### 4. Formato de saída definido
**Sem formato, a Skill improvisa estrutura toda vez.** Um dia vem tabela, outro dia bullet, outro dia texto corrido. A inconsistência destrói a confiança no output.
Diga exatamente como a resposta deve sair:
* 3 opções numeradas, 1 linha cada
* Tabela de 4 colunas (X, Y, Z, W)
* Texto corrido de até 200 palavras, sem subtítulo
* Email com 4 parágrafos fixos (abertura / contexto / proposta / CTA)
Quanto mais travado, mais consistente.
#### 5. Validação antes de salvar
**Maioria cria Skill, salva, testa uma vez e abandona.** Esse é o elemento que menos gente respeita e o que mais mata Skill.
Antes de fechar a Skill, peça pro Adapta One rodar ela num input real e mostrar o output. Se saiu no seu padrão, segue. Se não, ajusta a instrução na hora e roda de novo. Esse ciclo de 30 segundos é o que separa Skill que vive de Skill que morre.
***
### 🧪 Testes e segurança
Os 5 elementos fazem a Skill nascer bem. Para ela **continuar funcionando** quando o time inteiro usar ou quando tocar coisa sensível, você precisa de mais 2 camadas.
#### Teste com variação
Depois de salvar, roda a Skill com **3 a 5 inputs diferentes**, não só o que você usou para validar. Inputs curtos, longos, incompletos, fora do padrão. Se aguentar variação, tá robusta. Se quebra no segundo input estranho, volta e aperta a instrução.
#### Segurança e limites
Se a Skill toca dado sensível (contrato, valor, informação de cliente, regra interna), escreva no próprio texto da Skill o que ela **não pode fazer**. A IA respeita o que tá escrito na instrução.
Exemplos de limites para colocar no texto:
* "Nunca prometer prazo menor que 5 dias úteis"
* "Nunca compartilhar valores de honorários fora da tabela oficial"
* "Nunca enviar resposta sem o disclaimer obrigatório do final"
* "Se o input pedir algo fora do escopo, responder que não cobre e encerrar"
{% hint style="warning" %}
Skill compartilhada com a Empresa precisa ter seção de limites explícita. O que é óbvio para você pode não ser para quem usa a Skill copiada.
{% endhint %}
***
### 💼 3 Skills na prática
Três exemplos reais para calibrar como os 5 elementos aparecem no mundo real. Cada aba mostra o problema, o que entrou na Skill e como fica o uso no dia a dia.
{% tabs %}
{% tab title="Copywriter" %}
#### Headlines no tom do cliente
**Cenário:** Maria atende 4 clientes como copy freela. Cada um tem tom de voz diferente e ela gastava 20min por job explicando para IA qual usar.
**O que ela colocou na Skill:**
* Tarefa: gerar 3 headlines de anúncio a partir de um briefing colado
* Regra de tom do Cliente X: frases curtas, verbo no imperativo, proibido adjetivo vazio tipo "incrível" ou "revolucionário"
* Exemplos: 3 headlines aprovadas pelo cliente + 2 reprovadas com nota do porquê
* Formato de saída: 3 opções numeradas, 1 linha cada, sem subtítulo
**Como ela usa:** cola o briefing no chat. O Adapta One ativa a Skill sozinho e devolve as 3 opções.
**Resultado:** 20min → 2min por job. Cliente parou de pedir rodada de ajuste de tom.
{% endtab %}
{% tab title="Creator/Marketing (com ferramentas)" %}
#### Extrator de vídeos do YouTube → Newsletter pronta
**Cenário:** Pedro produz newsletter semanal sobre IA. Toda semana escolhia 3 canais, copiava os vídeos novos, assistia, resumia, extraía citações. 3 horas de trabalho repetitivo.
**O que tem dentro da Skill (texto + ferramentas):**
* Tarefa: recebe nome ou URL de um canal do YouTube, devolve pacote pronto pra newsletter
* **Browser tool**: navega no YouTube e coleta os 3 vídeos mais recentes
* **Transcrição automática**: puxa a transcrição do vídeo mais recente
* Gera 3 blocos prontos: resumo Início/Meio/Fim (\~450 palavras), 3-5 Key Quotes virais, bullet points com CTA pra newsletter
* Regra travada: tudo em português, mesmo que o vídeo original seja em inglês
**O ponto-chave:** Skill não é só texto. Essa aqui **usa um browser e um transcritor de vídeo** pra dar conta da tarefa. Quando texto puro não resolve, a Skill chama a ferramenta certa.
**Como ele usa:** digita "últimos vídeos do @LexFridman" no chat. Recebe tabela + resumo + quotes + bullets em menos de 2 minutos.
**Resultado:** 3h → 10min por newsletter. Pedro escalou de 3 pra 8 canais cobertos por semana sem contratar ninguém.
{% endtab %}
{% tab title="SDR" %}
#### Follow-up personalizado após reunião
**Cenário:** Carla é SDR B2B e faz 8 calls por dia. Gastava 10 minutos por call escrevendo o follow-up personalizado pra não soar genérico, e mesmo assim metade saía parecido.
**O que ela colocou na Skill:**
* Tarefa: gerar email de follow-up a partir de 4-5 bullets colados da call
* Estrutura fixa: abertura reconhecendo algo específico da conversa → 3 pontos de valor conectados com as dores que apareceram → 1 próximo passo claro com data → assinatura
* Tom: consultivo e direto. Proibido "foi um prazer", "excelente conversa", "gostaríamos muito" e outros clichês de vendas
* Exemplos: 2 emails reais que ela mandou e fecharam + 1 email rejeitado com a nota do que saiu genérico
**Como ela usa:** termina a call, cola 5 bullets no chat, recebe o email pronto pra enviar.
**Resultado:** 10min → 1min por email. Em 8 calls por dia, 72min de volta no calendário.
{% endtab %}
{% endtabs %}
***
### ✅ Como saber se está funcionando
{% tabs %}
{% tab title="Sinais positivos ✅" %}
* Output sai no seu padrão sem você precisar corrigir
* O agente ativa a Skill sozinho no momento certo
* Você usa a Skill 3+ vezes por semana
{% endtab %}
{% tab title="Sinais de alerta 🔻" %}
* Output volta genérico
* A Skill não ativa sozinha
* Você criou e nunca mais abriu
{% endtab %}
{% endtabs %}
***
### 🚨 Troubleshooting
| O que você vê | O que significa | Como corrigir |
| ------------------------ | --------------------------------- | --------------------------------------------- |
| Output ainda genérico | Faltam exemplos no texto da Skill | Adicione 2-3 outputs bons e 1 ruim |
| Skill não ativa sozinha | Gatilho vago ou descrição fraca | Reescreva como "toda vez que X, faça Y" |
| Formato varia a cada uso | Output não travado | Volta na instrução e define a estrutura exata |
| Criou e nunca mais usou | Skill genérica demais | Refaça com recorte mais específico |
***
### 🎯 Próximos passos
{% tabs %}
{% tab title="Começando agora" %}
**1. Abra a aba Adapta da Biblioteca** Leia 3 Skills prontas para calibrar o padrão antes de criar a sua.
**2. Escolha uma tarefa que você repete toda semana** Uma só. Quanto mais específica, melhor.
**3. Crie sua primeira Skill** Use qualquer um dos 3 jeitos da seção **Como criar uma Skill**. Menos de 2 minutos do começo ao fim.
{% endtab %}
{% tab title="Já está usando" %}
**1. Reveja suas Skills depois de 7 dias** Abra a aba Pessoais e olhe os sinais de alerta da seção acima.
**2. Compartilhe as boas com a Empresa** Se sua Skill funcionou, suba para aba Empresa e ganhe alavancagem.
**3. Refatora as que não ativam sozinhas** Foco no gatilho e na descrição. É aí que a maioria falha.
{% endtab %}
{% endtabs %}
