Visão geral de Skills
Uma skill é um pacote de instruções — em Markdown, com regras, exemplos e sub-referências — que ensina um assistente de IA a executar um fluxo específico do começo ao fim, sempre da mesma forma. Pense nela como um "manual do bom colega" que o assistente carrega no contexto no momento em que você aciona.
Diferente de uma pergunta solta, quando você invoca uma skill o assistente segue as regras daquela skill — a ordem certa, os campos obrigatórios, as armadilhas conhecidas — em vez de improvisar com base no que aprendeu no treinamento.
O que uma skill traz junto
Cada skill costuma incluir:
SKILL.md— o ponto de entrada, com o resumo do fluxo, regras transversais e o mapa das sub-referências.references/— sub-referências detalhadas por tópico ou domínio (endpoints, DTOs, exemplos de payload, regras de negócio).- Convenções internas — o que perguntar antes de começar, o que evitar, quais erros comuns já foram mapeados.
O assistente lê o SKILL.md na abertura e abre as sub-referências apenas
quando o assunto pede — isso mantém o contexto enxuto e evita respostas
"achismo".
Como invocar uma skill
Você aciona uma skill de duas formas:
- Comando direto — digite
/nome-da-skillou$nome-da-skill(dependendo do agente que estiver usando) no assistente. - Linguagem natural — descreva o que precisa e o assistente detecta a skill certa a partir das frases-gatilho declaradas nela. Ex.: "resuma esta reunião em tópicos", "organize esta lista de contatos no formato padrão".
Depois de invocada, a skill costuma fazer perguntas de clarificação antes de agir (ambiente, credenciais, contexto do projeto) — isso é intencional e evita retrabalho.
Onde as skills vivem
Fisicamente, as skills ficam em pastas versionadas — cada uma com seu próprio
SKILL.md e references/. O assistente descobre as skills disponíveis a
partir do diretório configurado no seu harness (o cliente/IDE de IA que você
usa) ou de um repositório interno do time. Cada harness tem seu próprio
diretório padrão e sua forma de recarregar skills — consulte a documentação
do harness que você usa para descobrir o caminho exato.
Catálogo de skills
| Skill | O que faz | Como invocar |
|---|---|---|
| ANYMARKET Backoffice API Guide | Guia completo da API v2 Backoffice do ANYMARKET — 17 domínios (produtos, SKUs, pedidos, estoque, preços, listings, NF-e, callbacks etc.), regras de autenticação, ambientes, paginação, rate limit e o padrão greenfield vs brownfield para integrações. | /anymarket-backoffice-api-guide — ou pedir em linguagem natural qualquer coisa relacionada a integração ERP ↔ ANYMARKET (TOTVS, Winthor, Protheus, SAP, ERP próprio). |
Como instalar uma skill
A ideia é sempre a mesma, independentemente do harness que você usa:
- Clone (ou baixe) o repositório da skill.
- Copie a pasta da skill para o diretório de skills que o seu harness lê.
- Recarregue o harness (reinício, comando de reload ou equivalente).
- Confirme que a skill aparece na lista de skills disponíveis (
/help, painel de configurações etc., conforme o harness).
O caminho exato do diretório e a forma de recarregar mudam de harness para harness — verifique a documentação oficial do seu antes de começar.
Se a skill trouxer um install.sh ou instruções específicas no SKILL.md,
siga o passo a passo de lá — algumas skills precisam de variáveis de
ambiente (tokens, endpoints) para funcionar.
Como criar uma nova skill
Para propor uma skill nova:
- Rascunhe qual fluxo você quer automatizar (input → passos → output esperado) e quais decisões o assistente precisa tomar no meio do caminho.
- Escreva o
SKILL.mdseguindo o padrão das existentes — frontmatter comnameedescription(as frases-gatilho vivem aqui), corpo com regras e mapa das sub-referências. - Quebre o conteúdo em sub-referências (
references/<topico>.md) para manter cada arquivo focado — o assistente só abre o que precisa. - Teste a skill com casos reais antes de publicar. Ajuste as frases-gatilho até o assistente detectar corretamente.
- Abra a proposta com o time de IA & Automação para review e publicação no repositório interno de skills.
Boas práticas
- Descrição da skill importa. É o que o assistente lê para decidir se aciona a skill — frases-gatilho vagas causam falsos positivos e negativos.
- Uma skill, um fluxo. Se você precisa cobrir dois fluxos muito distintos, provavelmente são duas skills.
- Perguntas antes de agir. Skills que fazem alterações sensíveis devem clarificar ambiente/credenciais/contexto antes de disparar qualquer chamada — evita retrabalho e erros em produção.
- Sub-referências enxutas. Cada arquivo em
references/deve caber em um único assunto. Contexto grande custa token e piora a qualidade da resposta.