La página
Una página es una dirección. Expresa una oferta. Solicita una acción. Un mapa del sitio es una lista de direcciones. Este pack rechaza esa lista.
La guía de construcción enseña a un humano. Este pack enseña a un agente.
Inicio
Si $ARGUMENTS es score, ejecuta el evaluador en gtm/page.json e informa cada línea. De lo contrario, $ARGUMENTS es lo que la página ofrece, o está vacío; redacta la página siguiendo la lista de verificación a continuación. El borrador se guarda en gtm/page.json; crea gtm/ si no existe.
Las tres partes
- URL. Una dirección https para esta página. No una lista de rutas.
- Oferta. Lo que la página pone en manos del lector, en una frase de 200 caracteres o menos.
- Acción. La única cosa que el lector hace en esa página, en una frase de 160 caracteres o menos.
Dos campos opcionales, evaluados solo cuando están presentes:
headline. Una frase, sin URL, y comparte una palabra con la oferta, para que la parte superior de la página nombre lo que ofrece.prueba. Una línea no vacía que respalde la oferta. Usa un resultado real; no inventes uno.
Cómo escribir cada parte
- URL. Usa la dirección que el usuario proporcione. Si no da ninguna, pídela. No inventes un dominio.
https://example.com/<slug>es solo un marcador de posición, y dilo. - Oferta. Nombra el resultado que el lector obtiene, no la empresa. Un sustantivo que el lector posee, un resultado que le proporciona.
- Acción. Comienza con un verbo que el lector realice: reservar, responder, comenzar, descargar, leer. Una frase verbal. "Reservar una llamada o descargar la guía" son dos acciones. Elige una.
Si el usuario trae dos ofertas, pregunta cuál lleva esta página. La otra recibe su propia página.
Desde brand-config.json
Si brand-config.json se encuentra en la raíz del proyecto, léelo antes de redactar. Solo lectura. Este pack no escribe nada en él.
evp.primaryes la línea de oferta. Úsala, o recórtala a una frase. También es elheadlinecuando el borrador tiene uno.evp.outcomela respalda en la página.evp.proof, cuando está presente, es la línea deproof; cuando está ausente, omiteproof.pricing.currentTiersnombra los niveles. La página vende un nivel; pregunta cuál. La acción coincide con él: iniciar una prueba, reservar una llamada, comprar.pricing.referenceAnchor.quantifiedes el marco de precio, si la página muestra un precio.
Si falta un bloque, di qué pack lo crea y pide al usuario la línea. No inventes una oferta o un precio. evp viene de /plugin install evp@gtm-operator-skills; pricing viene de /plugin install pricing@gtm-operator-skills.
Lista de verificación
Copia esta lista y márcala en orden.
- 1. Nombra la única URL.
- 2. Escribe el borrador en
gtm/page.json(creagtm/si falta):url,offer,action, yheadline/proofcuando los tengas. - 3. Ejecuta
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file gtm/page.json. - 4. Lee cada línea
- problema → arreglo. Realiza ese cambio. Vuelve al paso 3.
Detente cuando el script salga con 0. Muestra al usuario las líneas impresas y la línea Siguiente:.
Lo que el evaluador rechaza
| Línea de salida | Qué significa | Arreglo |
|---|---|---|
un mapa del sitio | kind es sitemap, una lista urls o pages, una lista en url, o una URL cuya ruta diga sitemap o termine en .xml | Mantén una dirección. Elimina la lista. |
url falta / url no es https / url no tiene host | La dirección está ausente o no es una URL https completa | Escribe https://host/path. |
url contiene más de una dirección | Dos URL en un mismo campo | Mantén una. |
más de una oferta / más de una acción | Una lista, o una clave offers, actions, o ctas | Elige una. Mueve la otra a su propia página. |
la oferta tiene más de una frase / la acción tiene más de una frase | Una segunda frase suele colar una segunda oferta o acción | Recorta a una frase. |
... es más largo de N caracteres | La línea no cabe en un titular o un botón | Recórtalo. |
el titular tiene más de una frase / el titular contiene una URL | El titular lleva una segunda idea o una dirección | Una frase. La URL vive en url. |
el titular no nombra la oferta | Ninguna palabra de más de tres letras se comparte con la oferta | Nombra el sustantivo o resultado de la oferta en el titular. |
la prueba está vacía / la prueba tiene más de una línea | La prueba está en blanco o se desborda a más de una línea | Una línea, o elimina el campo. |
Salida 0 significa que la página pasa; la última línea es Siguiente: /email-sequence:lifecycle-email. Salida 1 significa que falla: cada problema se imprime como - problema → arreglo, luego Siguiente: arregla las líneas anteriores y vuelve a ejecutar esto. Salida 2 significa que la entrada es inutilizable: no hay archivo, no es UTF-8, JSON roto o no es un objeto. Un JSON roto no repite la entrada sin procesar.
Ejecución
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/examples/page-good.json
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/examples/page-sitemap.json
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/examples/page-two-offers.json
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/examples/page-headline.json
python3 ${CLAUDE_PLUGIN_ROOT}/scripts/score.py --file ${CLAUDE_PLUGIN_ROOT}/examples/page-headline-refused.json
Agrega --json para obtener un objeto JSON con pass, sitemap, problems, fixes (uno por problema), next y los campos que pasaron.
Solo biblioteca estándar de Python. Sin red. Sin publicar.
Funciona con el conjunto
Este es el paso 7 del conjunto de habilidades GTM operator (/plugin marketplace add cmj-hub/gtm-operator-skills).
- Lee:
evpypricingdebrand-config.json, si están presentes. - Escribe: solo
gtm/page.json. Nunca toca las claves de otro pack. - Antes de esto: evp (
/evp:evp) cuando no hay línea de oferta; pricing (/pricing:pricing) cuando la página vende un nivel. - Después de esto: email-sequence (
/email-sequence:lifecycle-email) una vez que alguien se registra; geo (/geo:geo) cuando la página debe ser citada por un motor de respuestas.
Cuando la página pase, termina con Siguiente: /email-sequence:lifecycle-email (o /geo:geo cuando la página deba ser citada por un motor de respuestas). Si un pack complementario no está instalado, nómbralo y su línea de instalación (/plugin install <nombre>@gtm-operator-skills); no hagas su trabajo en línea.
Ejemplo de borrador
{
"url": "https://example.com/escritorio",
"offer": "Un escritorio de una página que nombra la filtración de la semana.",
"action": "Lee la página y responde con el único número que deseas a continuación."
}