Convertlyft

Skills do Convertlyft

Skills de agente para ler o comportamento do site, as evidências de conversão e SEO com Convertlyft. Cada skill identifica a ferramenta MCP exata que chama (servidor https://mcp.convertlyft.com/mcp) e sua equivalente REST (https://convertlyft.com/api/…, cabeçalho Authorization: Bearer cvl_pat_…). As skills especializadas também funcionam sem uma conta.

Este repositório é a cópia principal das skills.

Instalação

Cliente	Como
Claude Code	/plugin marketplace add Convertlyft/skills, depois /plugin install convertlyft@convertlyft. Adiciona o servidor MCP, todas as skills e um hook que pergunta antes de executar cvl_change_apply, cvl_operator_run, cvl_set_page_type ou cvl_remove_page_type_rule. Entre com /mcp → plugin:convertlyft:convertlyft → Authenticate.
Codex	codex plugin marketplace add Convertlyft/skills, depois codex plugin add convertlyft@convertlyft. Entre com codex mcp login convertlyft. Lê .codex-plugin/plugin.json.
Cursor	Dashboard → Plugins & MCPs → Add Marketplace → Import from Repo, com este repositório. Lê .cursor-plugin/.
Qualquer agente com Agent Skills (Codex, Cursor, Gemini CLI, Copilot e outros)	npx skills add Convertlyft/skills — somente skills; adicione o servidor MCP em convertlyft.com/developers.
Pelo site	npx skills add https://convertlyft.com — as mesmas skills, fixadas em um commit deste repositório, de convertlyft.com/.well-known/skills/index.json.

Todas as configurações MCP aqui apontam para https://mcp.convertlyft.com/mcp e enviam Convertlyft-Consumer: plugin, para que o Convertlyft possa identificar as chamadas feitas por um plugin. O cabeçalho não contém dados pessoais e não altera o que uma chamada pode fazer.

Skills

Skill	O que faz
adding-webmcp-tools	Adiciona ferramentas WebMCP a um site (ferramentas de formulário ou document.modelContext.registerTool), alinhando-as ao rascunho atual, sinalizando ferramentas arriscadas, testando no Chrome e verificando com a checagem de prontidão para agentes do Convertlyft, que não exige conta. Leitura complementar: webmcpagency.com.
adding-schema-markup	Planeja, escreve e audita dados estruturados (schema.org JSON-LD) para um site, escolhendo tipos por página, preenchendo-os apenas com fatos visíveis na página e validando antes da publicação.
applying-marketing-psychology	Explica os princípios comportamentais por trás do marketing persuasivo — prova social, autoridade, escassez, reciprocidade, aversão à perda, ancoragem, efeito chamariz, compromisso, enquadramento, efeito dotação, familiaridade, regra do pico-fim, excesso de opções, limites da memória de trabalho, distintividade, efeito halo e fluência cognitiva — indicando quando usar cada um e seus limites éticos.
auditing-shop-journeys	Audita toda a jornada de compra de uma loja virtual com base nos dados medidos do Convertlyft, removendo visitas que não são de compradores, encontrando a etapa que perde mais pessoas, sinalizando páginas que vendem muito abaixo da própria linha de base do site e páginas de produto que ficam atrás de produtos semelhantes, e priorizando mudanças com duas certezas: o problema é real e a mudança aumenta os pedidos.
auditing-site-seo	Audita o SEO de um site com o Convertlyft, começando com uma análise sem conta de qualquer site público, que retorna uma pontuação, os 3 principais problemas e um link para o relatório; depois, aprofunda a análise para espaços de trabalho autenticados, com o rastreamento armazenado, o conteúdo das páginas, oportunidades priorizadas, detalhes de palavras-chave e resumos de concorrentes.
diagnosing-conversion-drops	Diagnostica por que as conversões, vendas, inscrições ou consultas caíram em um site, comparando dois períodos de dados medidos do Convertlyft, restringindo a queda a uma origem, página de destino, etapa do funil, erro ou mudança de velocidade, e relatando apenas o que os dados comprovam.
finding-ux-friction	Encontra onde os visitantes têm dificuldades em um site — cliques de raiva, cliques sem resposta, formulários iniciados e abandonados, páginas que ninguém rola o suficiente e páginas lentas — com base nos dados medidos do Convertlyft, e prioriza os pontos pelo número de pessoas afetadas.
fixing-production-errors	Analisa os erros de JavaScript encontrados por visitantes reais em um site, escolhe o mais importante, prepara um resumo para correção (arquivo, linha, página, navegador, etapas anteriores e número de pessoas afetadas) para um desenvolvedor ou ferramenta de programação com IA e registra quando a correção entra no ar, para que o Convertlyft possa verificar se o problema continuou resolvido.
getting-started-with-convertlyft	Verifica como uma IA está conectada ao Convertlyft (se está autenticada, qual espaço de trabalho está usando e se a tag do site está enviando dados), explica o que é o Convertlyft e o que ele pode ver ou alterar e, em seguida, encaminha para a skill adequada à pergunta.
improving-page-speed	Encontra as páginas lentas para visitantes reais e o que mudar, analisando os Core Web Vitals (maior exibição de conteúdo, interação até a próxima exibição e deslocamento cumulativo de layout) por página, com base nos dados de velocidade medidos pelo Convertlyft, ponderando cada página lenta pelas vendas e consultas que gera e transformando as causas comuns (imagens grandes demais, scripts e estilos que bloqueiam a renderização, carregamento de fontes, conteúdo que chega tarde e desloca a página) em etapas e um trecho de código para uma pessoa aplicar.
improving-search-rankings	Diagnostica por que um site aparece ou não aparece nos resultados de busca e decide o que corrigir primeiro, abrangendo indexação, intenção de busca, títulos, links internos, qualidade do conteúdo, backlinks, acompanhamento de posições, busca local, visibilidade em assistentes de IA e como as páginas de destino afetam a qualidade do Google Ads.
measuring-with-analytics	Configura, audita e corrige a medição de sites — instalação de tags, acompanhamento de eventos e eventos principais, marcação de campanhas UTM, acompanhamento entre domínios e verificação de dados — para o Google Analytics 4 e a tag do Convertlyft.
optimizing-conversions	Diagnostica por que os visitantes de um site não compram, não se inscrevem ou não fazem consultas e decide o que mudar primeiro e em que ordem, com evidências honestas — funis, mapas de calor, gravações de visitas, formulários, checkout, testes A/B e o que acontece após a primeira conversão.
optimizing-local-service-pages	Melhora as páginas de serviços e localidades de uma empresa que atende pessoas em uma região, verificando se nome, endereço e telefone correspondem em todos os lugares, se o schema LocalBusiness contém apenas fatos verdadeiros, se há uma página por área de atendimento somente quando ela tem conteúdo local relevante, se a página mostra quem está por trás da empresa e se as avaliações são conquistadas e exibidas com honestidade, usando o rastreamento do Convertlyft, as conversões das páginas e os resultados de busca atuais.
optimizing-product-category-pages	Melhora ao mesmo tempo as páginas de produto e de categoria de uma loja, tanto a proporção de visitas que adicionam ao carrinho ou compram quanto a forma como as páginas aparecem nas buscas, usando as conversões medidas por página, os caminhos, os mapas de calor e as gravações de visitas do Convertlyft; depois, trabalha títulos, meta descriptions, textos exclusivos, schema Product e cuidados com URLs de filtros e duplicadas.
planning-content	Pesquisa, estrutura, redige e revisa artigos e conteúdo de páginas de destino que atendem leitores, mecanismos de busca e assistentes de IA ao mesmo tempo, sem inventar fatos, estatísticas ou experiências que o proprietário não tem.
planning-improvements	Transforma tudo o que se sabe sobre um site em um plano de melhorias ordenado, dividido entre trabalho no site e atração de pessoas para ele, priorizando primeiro a medição, depois os reparos, em seguida o maior ponto de perda e, por último, o tráfego novo.
profiling-competitors	Analisa um concorrente com base em evidências públicas — posicionamento, oferta, presença nas buscas, conteúdo, qualidade do site e visibilidade em assistentes de IA — e transforma a análise em ações priorizadas e respaldadas por evidências, separando fatos observados de suposições.
reading-behaviour-data	Ensina a interpretar honestamente as evidências do comportamento dos visitantes — mapas de calor, profundidade de rolagem, cliques de raiva e cliques sem resposta, atrito em formulários, funis, caminhos e gravações de sessões — e a transformar uma análise em um diagnóstico da página e uma hipótese testável.
researching-seo-competitors	Pesquisa com quem um site compete nas buscas usando os dados de SEO armazenados pelo Convertlyft e, quando eles não respondem à pergunta, pesquisa ao vivo qualquer domínio incluído no plano, dentro de um limite diário para dados de busca paga. Abrange a lista de concorrentes por nível, as buscas em que os rivais vencem, posições lado a lado com rivais, lacunas de backlinks, menções em assistentes de IA, resumos armazenados e a matriz entre sites para membros com vários espaços de trabalho; registra escolhas de concorrentes e palavras-chave somente com a aprovação do proprietário.
reviewing-ux-ui	Avalia a UX e a UI de um site como um proprietário precisa — layout, hierarquia visual, legibilidade, navegação, formulários, atrito em inscrições e checkout, estados de erro e vazios, comportamento em dispositivos móveis, acessibilidade, confiança e velocidade percebida — e prioriza as correções por gravidade, apresentando as evidências de cada uma.
running-paid-ads	Diagnostica anúncios pagos — Google Ads, Meta, anúncios do Facebook e Instagram — na ordem certa (rastreamento, depois economia, depois para onde vai o dinheiro, depois qualidade das consultas e do público, depois a página de destino e, por fim, lances e estrutura.
shipping-cro-fixes	Acompanha uma correção de conversão desde a descoberta até a decisão do proprietário e o resultado medido pelo Convertlyft, colocando uma proposta na fila para o proprietário, visualizando e registrando um marcador de alteração somente após a aprovação do proprietário, desfazendo um marcador quando necessário e registrando a conclusão no histórico do espaço de trabalho.
sorting-page-types	Classifica as páginas de um site por tipo junto com o proprietário, começando pelas páginas que mais precisam da atenção dele, propondo um tipo com base no que cada página realmente mostra, visualizando cada alteração e aplicando-a somente após a aprovação do proprietário no chat; depois, usa os tipos para responder a perguntas de análise e SEO por categoria de página.
watching-session-replays	Encontra a gravação de visita certa e analisa um momento dela — as páginas, os elementos clicados, os erros e o tamanho do texto digitado nos segundos próximos a um clique de raiva, clique sem resposta ou erro — para confirmar ou descartar uma hipótese baseada em análises.
writing-copy	Escreve, reescreve e edita textos de marketing para páginas iniciais, páginas de destino, páginas de preços, anúncios, e-mails e chamadas para ação, verificando clareza, especificidade, benefícios, provas e linguagem dos clientes.
writing-daily-site-briefs	Escreve um breve relatório diário de um site com base no Convertlyft, cobrindo se a tag está enviando dados, o que o monitoramento ao vivo sinalizou, os principais números de ontem em comparação com o dia anterior, novos erros, o que está em aberto no quadro de ações e o que aguarda a decisão do proprietário, sem repetir o que o espaço de trabalho já sabe.
writing-site-reviews	Escreve uma análise mensal, semanal ou de um período personalizado do site, que o proprietário e a equipe possam usar para agir. Cada item parte do que foi observado, compara com uma linha de base equivalente e explica o motivo, o valor, a correção e como a próxima análise vai verificá-la. Abrange visitantes reais, a etapa do funil com perdas, páginas abaixo do desempenho esperado para seu tipo, destinos de visitas pagas, pontos de dificuldade, conteúdo visível sem rolar em celulares, buscas, backlinks, resumos pendentes e o que não vale a pena perseguir.

Verificações

A CI é executada a cada push e pull request, e a verificação de divergências é executada diariamente:

• node scripts/lint-skills.mjs — nomes no gerúndio, descrições na terceira pessoa, corpos com menos de 500 linhas, referências com um nível de profundidade e todas as ferramentas na tabela Tools da skill com sua equivalente REST. Em relação a scripts/live-tools.json (a lista de ferramentas ativas, mantida pela verificação de divergências): todas as ferramentas mencionadas por uma skill existem, todos os argumentos que ela envia ({"name": …, "arguments": {…}} ou "cvl_x com a") estão no inputSchema dessa ferramenta, um escopo associado a uma ferramenta é necessário para ela e uma ferramenta fora da lista padrão tem uma linha em Tools que diz "via cvl_call_read". node --test scripts/lint-skills-lib.test.mjs testa essas regras.
• node scripts/check-manifests.mjs — os manifestos do Claude Code, Codex e Cursor concordam quanto ao nome e à versão, cada configuração MCP aponta para o servidor correto e envia o cabeçalho do cliente, e o hook intercepta exatamente cvl_change_apply, cvl_operator_run, cvl_set_page_type e cvl_remove_page_type_rule.
• claude plugin validate --strict . (o marketplace) e claude plugin validate --strict .claude-plugin/plugin.json (o plugin e seus hooks).
• node scripts/check-drift.mjs — todas as ferramentas, rotas REST e escopos mencionados por uma skill devem existir no servidor ativo (MCP tools/list, /.well-known/convertlyft-capabilities.json, /openapi.json), e o skills/getting-started-with-convertlyft/references/convertlyft-api.md gerado deve corresponder a ele, assim como scripts/live-tools.json. --write regenera ambos.
• claude plugin eval . com ferramentas simuladas (evals/). Ignorado com um aviso quando o segredo ANTHROPIC_API_KEY não está definido.

Licença

MIT — consulte LICENSE. reading-behaviour-data adapta a skill cro de Corey Haines sob sua licença MIT; consulte NOTICE.