Documentação

Agentes de IA (MCP)

Skills de playbook

Os 22 playbooks que o servidor MCP do AmICited distribui como recursos de skill: quais ferramentas chamar, em que ordem, e as armadilhas que tornam errada uma resposta confiante.

As ferramentas são o que um agente consegue alcançar. As skills são como usá-las para uma pergunta real. Com mais de 300 ferramentas, a parte difícil raramente é encontrar uma: é saber que “por que o tráfego caiu” precisa de seis relatórios em uma ordem específica, ou que um relatório de ecommerce vazio pode significar “não conectado” em vez de “receita zero”.

O servidor MCP do AmICited distribui esses playbooks como recursos MCP. Cada um foi escrito dando a agentes perguntas difíceis contra o servidor real, sem playbook, registrando cada beco sem saída e cada suposição errada e transformando essas falhas em instruções. Todo nome de ferramenta que uma skill menciona é verificado contra o registro real de ferramentas a cada build, então uma skill nunca aponta para uma ferramenta que não existe mais.

Como os agentes as encontram#

As skills são servidas em skill://<name>/SKILL.md. Listá-las custa um nome e uma linha cada; o corpo só é buscado quando um agente o quer.

  • As instruções do servidor, enviadas a todo cliente ao conectar, dizem ao agente para ler skill://using-amicited/SKILL.md primeiro. Essa skill explica o ciclo encontrar, inspecionar, executar e lista as outras.
  • Muitos clientes nunca listam recursos por conta própria. Se seu agente parecer não conhecer uma skill, nomeie-a: “Read skill://ai-visibility-audit/SKILL.md, then audit example.com.”
  • As skills são texto somente leitura. Lê-las não conta para o limite horário de chamadas de ferramentas.

Convenções#

SkillFinalidade
using-amicitedComo conduzir o endpoint: encontrar a ferramenta certa entre mais de 300, invocá-la e as convenções que todas as outras skills pressupõem. Leia primeiro.
report-windowsJanelas de datas e períodos de comparação entre relatórios: os diferentes estilos de argumento, a regra de mesma duração e como evitar números confiantes, porém errados.

Visibilidade em IA e concorrentes#

SkillFinalidade
ai-visibility-auditDiagnosticar por que uma marca é ou não citada nas respostas de IA: quais mecanismos realmente rodaram, o que o número principal esconde e quatro verificações que explicam uma lacuna.
competitor-gap-analysisEncontrar onde os concorrentes ganham respostas de IA e buscas que você não ganha, e quais lacunas atacar primeiro.
competitor-content-gapsEncontrar seções de sitemap, vocabulário e lacunas de publicação dos concorrentes sem exagerar dados de atualidade incompletos.
ai-fanout-queriesEncontrar as buscas que um assistente de IA executou no seu site (as que carregam um operador site:) e lê-las sem confundir zero cliques com um problema.
prompt-set-designAdicionar prompts rastreados a um domínio: como é um bom conjunto de prompts, a armadilha das tags e por que nada aqui consegue informar o custo em créditos.

Diagnósticos de busca orgânica#

SkillFinalidade
traffic-drop-triageDescobrir por que o tráfego orgânico mudou: localizá-lo em uma consulta ou página, datar a queda e descartar indexação, interrupções e mudanças no site antes de culpar os rankings.
did-our-change-workCorrelacionar uma mudança no site com o que aconteceu depois, e por que um histórico de anotações vazio não é evidência de nada.
indexing-triageInvestigar problemas de indexação: qual ferramenta responde a qual metade, por que um veredito nulo não é um não e o padrão de 404 sem redirecionamento.
cannibalization-cleanupEncontrar páginas que disputam a mesma consulta e por que o topo do ranking de gravidade costuma ser ruído de marca.
page-familiesLer uma página e suas traduções como uma só família e relacionar uma mudança de tráfego a uma edição de hreflang ou canônica.
site-audit-reviewPrecificar, executar e interpretar auditorias de site por sitemap para corrigir problemas técnicos e melhorar a autoridade de links internos.
backlinks-reviewJulgar se os backlinks monitorados ainda têm valor: o que “ativo” esconde, perdido vs. inacessível e a comparação da autoridade com a dos concorrentes.

Dinheiro#

SkillFinalidade
profitability-deep-diveInformar o lucro do ecommerce com honestidade: verificar a cobertura de custos antes de citar qualquer margem, porque um custo não configurado é lido como zero.
customer-valueValor do cliente ao longo do tempo, coortes e recompra, e por que a janela precisa ser longa.
paid-waste-reviewEncontrar gasto desperdiçado em anúncios sem inventar lucro, inclusive quando o valor de conversão não é realmente dinheiro.
seo-to-revenueDefender o trabalho orgânico em dinheiro, e não em cliques, depois de verificar que existem dados do canal para atribuir a receita.

Operações e entregáveis#

SkillFinalidade
platform-onboardingConectar uma plataforma de dados a um domínio e importar seu histórico: a cadeia de cotação e confirmação e onde o dinheiro é comprometido.
uptime-setupConfigurar monitores, alertas, sinais de vida, janelas de manutenção e uma página de status sem padrões meio configurados.
availability-reviewResponder “o site estava no ar, o que quebrou e há algo fora do ar agora”, incluindo as regras de mês-calendário do relatório de SLA.
recurring-reportsProduzir um relatório semanal de SEO ou mensal de ecommerce comparável ao anterior: janelas fixas, ferramentas fixas, ressalvas mantidas.

O que uma skill muda na prática#

Dois exemplos do que os playbooks captam e os esquemas das ferramentas não:

  • O detalhamento por provedor esconde mecanismos silenciosos. O detalhamento por plataforma do dashboard lista apenas os mecanismos que citaram você. A ai-visibility-audit leva o agente a get_prompt_detail, que mostra para cada mecanismo se ele rodou e se citou você, de modo que “24% de visibilidade” vira “citado pelo Perplexity, ignorado pelo ChatGPT”. Veja sem dados de um mecanismo.
  • Não conectado não é zero. A using-amicited faz o agente verificar se uma plataforma está conectada antes de informar que ela não tem dados e leva você a Fontes de dados quando não está.

Nomeie a skill no seu pedido quando souber qual é a pergunta: “Use the traffic-drop-triage skill to explain last week’s drop on example.com.” O agente lê o playbook primeiro e segue a ordem dele. A página de receitas traz prompts prontos.

Relacionados#