Geo Review Html

Renderiza formularios de revisión HTML autocontenidos a partir de briefs/borradores GEO, exportando la entrada del cliente como JSON

Por ViryaZheng · ViryaZheng/recomby-geo

Probado · Funciona ★ 9.6/10

Geo Review Html — Renderiza formularios de revisión HTML autocontenidos a partir de briefs/borradores GEO, exportando la entrada del cliente como JSON

Qué hace

Un script de la stdlib de Python que renderiza un brief de contenido GEO o un borrador listo para publicar en una única página HTML autocontenida, para que un cliente no técnico pueda rellenar los slots REQUIRED-FILL, dejar comentarios en las secciones y aprobar o devolver el trabajo en el navegador, exportando su entrada como un archivo JSON que coincide con review_feedback.schema.json. Se activa cuando un brief o borrador debe ir a un cliente/experto para revisión, o al construir la página de entrada briefs/index.html de la carpeta de un cliente. La lógica de interacción está fijada en templates/review.html; la capa visual se delega a la skill frontend-design.

Informe de la prueba

Se clonaron los archivos referenciados (SKILL.md, scripts/render_html.py, templates/review.html, schema — todos HTTP 200) y se ejecutó el script de principio a fin en un directorio temporal en los tres modos. El modo brief dividió mi Markdown de prueba en blockquotes REQUIRED-FILL en textareas de slot (data-1, quote-1) y añadió el slot solo de metadatos data-2; el modo draft dividió por H2 en secciones intro/sec-*; el modo index escaneó briefs/ y drafts/ meta.json en tarjetas con recuentos correctos de slots/rellenos. Se verificó que los marcadores de posición se reemplazaron completamente, el primary_color #0055ff de la marca se inyectó como anulación de acento, y la exportación de la plantilla construye exactamente el objeto requerido por el esquema (brief_id, filled_at, filled_by, answers, comments, status). La línea base era un formulario estático escrito a mano de 486 bytes; la salida de la skill es un archivo autocontenido de 18.9KB con autoguardado en localStorage (4 refs), exportación/descarga JSON (10), máquina de estados de aprobación (7), alternadores de comentarios (24) y desplegables de detalles de guía de slots (8) — ninguno presente en la línea base. Limpio: stdlib pura, escapa la entrada HTML, escapa la barra de cierre en el blob JSON; sin problemas de seguridad.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/ViryaZheng/recomby-geo.git /tmp/geo-review-html-src
mkdir -p ~/.claude/skills
cp -R /tmp/geo-review-html-src/plugins/recomby-geo/skills/geo-review-html ~/.claude/skills/geo-review-html
# Pure Python 3 stdlib — no pip installs. templates/review.html and scripts/render_html.py travel inside the skill dir, so it runs standalone.
# Run e.g.: python3 ~/.claude/skills/geo-review-html/scripts/render_html.py --mode brief --md brief.md --meta brief.meta.json --brand brand.json --out out.html
# Modes: brief (fill-form) | draft (section comments + approve) | index (client folder entry page).
# review_feedback.schema.json lives at plugins/recomby-geo/schemas/ in the repo (documentation only; the script does not load it).

Comandos y prompts de ejemplo

  • /geo-review-htmlRenderiza formularios de revisión HTML autocontenidos a partir de briefs/borradores GEO, exportando la entrada del cliente como JSON

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Create a client review page for this content brief
  • Build an HTML approval page for the draft article
  • Let the client fill in required slots and comment