# 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 %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.adapta.org/inicio-rapido/skills.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.