A página
Uma página é um endereço. Ela declara uma oferta. Ela pede uma ação. Um sitemap é uma lista de endereços. Este pacote recusa essa lista.
O guia de construção ensina um humano. Este pacote ensina um agente.
Início
Se $ARGUMENTS for score, execute o avaliador em gtm/page.json e relate cada linha. Caso contrário, $ARGUMENTS é o que a página oferece, ou vazio; crie a página com a lista de verificação abaixo. O rascunho fica em gtm/page.json; crie gtm/ se não existir.
As três partes
- URL. Um endereço https para esta página. Não é uma lista de caminhos.
- Oferta. A coisa que a página coloca nas mãos do leitor, em uma frase de 200 caracteres ou menos.
- Ação. A única coisa que o leitor faz naquela página, em uma frase de 160 caracteres ou menos.
Dois campos opcionais, pontuados apenas quando presentes:
headline. Uma frase, sem URL, e que compartilha uma palavra com a oferta, para que o topo da página nomeie o que ela entrega.proof. Uma linha não vazia que respalda a oferta. Use um resultado real; não invente um.
Como escrever cada parte
- URL. Use o endereço que o usuário fornecer. Se ele não fornecer nenhum, peça-o. Não invente um domínio.
https://exemplo.com/<slug>é apenas um espaço reservado, e diga isso. - Oferta. Nomeie o resultado que o leitor obtém, não a empresa. Um substantivo que o leitor segura, um resultado que ele entrega.
- Ação. Comece com um verbo que o leitor executa: agendar, responder, iniciar, baixar, ler. Uma frase verbal. "Agendar uma chamada ou baixar o guia" são duas ações. Escolha uma.
Se o usuário trouxer duas ofertas, pergunte qual delas esta página carrega. A outra ganha sua própria página.
De brand-config.json
Se brand-config.json estiver na raiz do projeto, leia-o antes de criar o rascunho. Apenas leia. Este pacote não escreve nada nele.
evp.primaryé a linha da oferta. Use-a ou reduza-a a uma frase. Também é oheadlinequando o rascunho tiver um.evp.outcomea apoia na página.evp.proof, quando presente, é a linha deproof; quando ausente, deixeproofde fora.pricing.currentTiersnomeia as faixas. A página vende uma faixa; pergunte qual. A ação corresponde a ela: iniciar um teste, agendar uma chamada, comprar.pricing.referenceAnchor.quantifiedé o quadro de preço, se a página mostrar um preço.
Se um bloco estiver faltando, diga qual pacote o cria e peça ao usuário a linha. Não invente uma oferta ou um preço. evp vem de /plugin install evp@gtm-operator-skills; pricing vem de /plugin install pricing@gtm-operator-skills.
Lista de verificação
Copie esta lista e marque-a em ordem.
- 1. Nomeie a única URL.
- 2. Escreva o rascunho em
gtm/page.json(criegtm/se não existir):url,offer,actioneheadline/proofquando você os tiver. - 3. Execute
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file gtm/page.json. - 4. Leia cada linha
- problema → correção. Faça essa alteração. Volte ao passo 3.
Pare quando o script sair com 0. Mostre ao usuário as linhas impressas e a linha Próximo:.
O que o avaliador recusa
| Linha de saída | O que significa | Correção |
|---|---|---|
um sitemap | kind é sitemap, uma lista de urls ou pages, uma lista em url ou um URL cujo caminho diz sitemap ou termina em .xml | Mantenha um endereço. Remova a lista. |
url está faltando / url não é https / url não tem host | O endereço está ausente ou não é um URL https completo | Escreva https://host/path. |
url contém mais de um endereço | Dois URLs em um campo | Mantenha um. |
mais de uma oferta / mais de uma ação | Uma lista, ou uma chave offers, actions ou ctas | Escolha uma. Mova a outra para sua própria página. |
oferta tem mais de uma frase / ação tem mais de uma frase | Uma segunda frase geralmente introduz uma segunda oferta ou ação | Corte para uma frase. |
... é mais longo que N caracteres | A linha não cabe em um título ou botão | Corte-a. |
headline tem mais de uma frase / headline contém um URL | O título carrega uma segunda ideia ou um endereço | Uma frase. O URL vive em url. |
headline não nomeia a oferta | Nenhuma palavra com mais de três letras é compartilhada com a oferta | Nomeie o substantivo ou resultado da oferta no título. |
proof está vazia / proof tem mais de uma linha | A prova está em branco ou se estende por mais de uma linha | Uma linha, ou remova o campo. |
Saída 0 significa que a página passa; a última linha é Próximo: /email-sequence:lifecycle-email. Saída 1 significa que falha: cada problema imprime como - problema → correção, depois Próximo: corrija as linhas acima e execute novamente. Saída 2 significa que a entrada é inutilizável: nenhum arquivo, não UTF-8, JSON quebrado ou não é um objeto. Um JSON quebrado não ecoa a entrada bruta.
Executar
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/exemplos/page-good.json
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/exemplos/page-sitemap.json
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/exemplos/page-two-offers.json
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/exemplos/page-headline.json
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/exemplos/page-headline-refused.json
Adicione --json para obter um objeto JSON com pass, sitemap, problems, fixes (um por problema), next e os campos que passaram.
Apenas biblioteca padrão do Python 3. Sem rede. Sem publicação.
Funciona com a suíte
Este é o passo 7 da suíte do operador GTM (/plugin marketplace add cmj-hub/gtm-operator-skills).
- Lê:
evpepricingdebrand-config.json, se presente. - Escreve: apenas
gtm/page.json. Nunca toca nas chaves de outro pacote. - Antes disso: evp (
/evp:evp) quando não houver linha de oferta; pricing (/pricing:pricing) quando a página vender uma faixa. - Depois disso: email-sequence (
/email-sequence:lifecycle-email) quando alguém fizer opt-in; geo (/geo:geo) quando a página precisar ser citada por um mecanismo de respostas.
Quando a página passar, termine com Próximo: /email-sequence:lifecycle-email (ou /geo:geo quando a página precisar ser citada por um mecanismo de respostas). Se um pacote complementar não estiver instalado, nomeie-o e sua linha de instalação (/plugin install <nome>@gtm-operator-skills); não faça o trabalho dele embutido.
Exemplo de rascunho
{
"url": "https://exemplo.com/mesa",
"offer": "Uma mesa de uma página que nomeia o vazamento da semana.",
"action": "Leia a página e responda com o único número que você quer a seguir."
}