Guia prático da camada de Skills da UnifAPI: frases de ativação, chamadas de dados, templates de saída, regras de confiança e limites dos dados públicos.

Em resumo: uma Skill é a unidade repetível dentro de um Agent da UnifAPI. Ela diz ao assistente quando usar o fluxo de trabalho, quais dados buscar, como estruturar a saída e onde parar.

Prompts são fáceis de escrever e difíceis de manter. Um fluxo de trabalho de marketing útil precisa de mais do que uma instrução. Ele precisa de gatilhos, requisitos de entrada, escolhas de fonte de dados, regras de confiança, templates de saída e limites.

É por isso que os Agents da UnifAPI são implementados como Skills.

O que pertence a uma Skill

Parte da Skill	O que faz
Nome e descrição	Ajuda o assistente a rotear para o fluxo de trabalho certo
Quando usar	Lista frases de gatilho e intenções do usuário
Entradas	Diz ao assistente que contexto coletar antes de chamar os dados
Chamadas de dados	Nomeia as operações da UnifAPI ou as Data Skills a usar
Fluxo de trabalho	Transforma a tarefa em passos
Template de saída	Evita resumos vagos
Regras de confiança	Separa fatos observados de julgamento inferido
Limites	Mantém o Agent somente leitura e honesto

Uma Skill é mais forte quando nomeia uma capacidade. keyword-research é uma Skill. seo-audit é uma Skill. ai-answer-gap é uma Skill. "Fazer todo o marketing" não é.

Skills Enhanced, Advice e Data

A UnifAPI usa três tipos de Skill:

Tipo de Skill	O que significa	Exemplo
Enhanced	Uma capacidade de marketing que chama dados públicos ao vivo	Auditoria de SEO, precificação de KOL, auditoria de visibilidade em AI
Advice	Framework ou julgamento sem uma chamada ao vivo	Orientação de schema, frameworks de posicionamento
Data	Um guia de fonte determinístico de propriedade de um Platform Agent	LinkedIn Data Skill, Reddit Data Skill

Essa distinção mantém o produto claro. Nem toda Skill útil de marketing precisa de uma chamada de API ao vivo. Mas quando uma Skill faz uma afirmação factual sobre visibilidade pública, ela deve usar registros.

Por que as Skills devem nomear operações

Um assistente pode descobrir operações por meio do MCP, mas a descoberta não é o fluxo de trabalho inteiro. Uma boa Skill ainda deve dizer ao assistente quais famílias de dados importam para a tarefa.

Por exemplo, uma Skill de auditoria de SEO pode dizer:

Puxe evidência de SERP ao vivo para as consultas-alvo.
Use visão geral e histórico de palavras-chave para o contexto de demanda.
Use o Browser Markdown para a página-alvo e as principais páginas de concorrentes.
Retorne um plano de correção com evidência observada e recomendações separadas.

Isso é muito melhor do que: "Use a API se necessário".

Templates de saída fazem parte do produto

O formato de saída é onde muitos fluxos de trabalho de agents falham. Sem um template, o assistente pode retornar um resumo agradável sobre o qual não dá para agir.

Uma Skill deve especificar o artefato:

Fluxo de trabalho	Artefato útil
Precificação de KOL	Tabela de criadores ranqueada com faixas baixa/base/alta e confiança
Auditoria de GEO	Matriz de citação e menção, prompt por prompt
Varredura de local pack	Consulta, ranking, concorrentes, contagem de avaliações e posição no mapa
Perfil de concorrente	Linha do tempo de lançamento, canais, afirmações, provas e riscos
Estratégia de conteúdo	Backlog de oportunidades com demanda, evidência de fonte e aderência

Templates não tornam o assistente robótico. Eles tornam a resposta revisável.

Regras de confiança previnem certeza falsa

Os dados públicos são poderosos, mas não são oniscientes. Uma Skill deve fazer o assistente rotular:

Rótulo	Significado
Observado	Lido diretamente de um registro público
Inferido	Deduzido de vários registros
Assumido	Fornecido pelo usuário ou necessário para concluir a análise
Desconhecido	Não disponível a partir de dados públicos

Isso importa nos fluxos de trabalho de marketing. Uma Skill de precificação de KOL pode estimar uma faixa, não uma cotação final. Uma Skill de GEO pode reportar visibilidade, não garantir inclusão futura. Uma Skill de SEO local pode auditar listagens, não editá-las.

Um checklist curto de qualidade de Skill

Antes de publicar uma Skill, pergunte:

Ela mapeia para uma tarefa concreta?
A descrição inclui frases de gatilho reais?
Ela especifica entradas obrigatórias e opcionais?
Ela nomeia as fontes de dados ou as Data Skills a usar?
Ela inclui um template de saída?
Ela explica confiança e limites?
Ela tem links para Skills relacionadas para o trabalho de continuidade?

Se a resposta for não, a Skill é provavelmente um rascunho de prompt, não um fluxo de trabalho.

O que ler a seguir

Platform Agents e Data Skills - mostra a versão específica de fonte das Skills.

Arquitetura Agent First - explica onde as Skills ficam entre os Agents e as APIs.

Explore as Skills da UnifAPI - veja as páginas de Skill ao vivo.