Geo Review Html

Turns GEO content briefs and production drafts into self-contained HTML review forms that non-technical clients can actually use. Instead of asking a domain expert to edit Markdown, you hand them a browser file where they fill REQUIRED-FILL slots in textareas, leave section comments, and click approve or return. Their answers come back as JSON that Step 9 of the brief workflow ingests directly. Battle-tested on a 9-draft batch. The interaction logic is locked down in a template (localStorage autosave, export, progress tracking), but you can restyle the CSS via the frontend-design skill if a client wants branding. Also generates index pages that show live progress across all briefs in a folder. Pure standard library Python, no dependencies, outputs one file you can email.

GitHub stars: 415
last updated: Jun 9, 2026

View on GitHub

Install

$ npx -y skills add recomby-ai/recomby-geo --skill geo-review-html --agent claude-code

Installs into .claude/skills of the current project.

Files

geo-review-html — interactive client-review HTML

The Markdown briefs/drafts are right for the GEO operator; they are awkward for the client side. This skill renders a companion HTML alongside the Markdown so non-technical reviewers can work in the browser. Battle-tested in the SEA-CICSIC 9-draft batch (see issue #1).

Division of labour (do not blur this):

Interaction logic is fixed — templates/review.html owns localStorage auto-save, JSON export, the progress counter, comment toggles, and the approve/return state machine. It is correct as written; do not regenerate it per run.
Visual layer is the template's CSS — that is where the vendored frontend-design skill applies. When a client wants a branded or more distinctive look, restyle the <style> block of templates/review.html using frontend-design principles. --accent is already overridable per client via brand_context (see below); deeper restyling edits the CSS.
render_html.py only parses Markdown + meta into a payload and injects it.