Agent skill

Geo Review HTML

by ViryaZheng in ViryaZheng/recomby-geo

Render an interactive, self-contained HTML companion for a GEO content brief (04-content-brief) or a publish-ready draft (05-production), so a NON-technical client reviewer (founder, organizer…

MITAuto-check passedWriting & Content

Install Geo Review HTML

skills CLI
$ npx skills add ViryaZheng/recomby-geo --skill geo-review-html -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ViryaZheng/recomby-geo geo-review-html --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ViryaZheng/recomby-geo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/recomby-geo/skills/geo-review-html .claude/skills/geo-review-html && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
geo-review-html
GitHub stars
458
Token cost
~1.3k tokens
SKILL.md length
429 words
Files
3 (incl. scripts)
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Render an interactive, self-contained HTML companion for a GEO content brief (04-content-brief) or a publish-ready draft (05-production), so a NON-technical client reviewer (founder, organizer…

  • Works in 3 steps: Never auto-fill answers — the JSON… → Keep the interaction JS fixed — restyle… → Output stays self-contained — one file,…
  • Draft needs to go to a client/expert for review
  • SKILL.md covers When to use, Usage, How it maps the inputs and Returned feedback contract, plus 1 more section
  • Runs Python scripts from its folder; calls python3

What it does

Geo Review HTML is an agent skill from ViryaZheng/recomby-geo. Render an interactive, self-contained HTML companion for a GEO content brief (04-content-brief) or a publish-ready draft (05-production), so a NON-technical client reviewer (founder, organizer staff, the domain expert filling slots) can fill REQUIRED-FILL slots, leave section-level comments, and approve/return work in the browser instead of editing Markdown. Use when a brief or draft needs to go to a client/expert for review, or when building the briefs/index.html entry page for a client folder. The reviewer's…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `scripts/render_html.py`).

It sits in Writing & Content, covering Content strategy and AI search optimization. The repository describes itself as: GEO 领域 AI 员工开源方案 · Open-source GEO AI-employee solution (MIT). GEO Skills package + curated lists of agents and office CLIs that make up the AI-employee stack. The licence is MIT.

When your agent uses it

  • Draft needs to go to a client/expert for review
  • Building the briefs/index.html entry page for a client folder

Example prompts

  • “/geo-review-html”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Never auto-fill answers — the JSON carries the human's real input;
  2. Keep the interaction JS fixed — restyle CSS freely (frontend-design),
  3. Output stays self-contained — one file, no external CSS/JS, so a

What it can do on your machine

Read from SKILL.md and the folder at commit 530d5e2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Geo Review HTML loads about 1.3k tokens when it runs. Until then it costs about 165 tokens; SKILL.md has 429 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~165
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from ViryaZheng/recomby-geo at commit 530d5e2, republished under its MIT licence (© ViryaZheng). 429 words, ~1,295 tokens.

Download SKILL.mdSave it as .claude/skills/geo-review-html/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
geo-review-html
description
Render an interactive, self-contained HTML companion for a GEO content brief (04-content-brief) or a publish-ready draft (05-production), so a NON-technical client reviewer (founder, organizer staff, the domain expert filling slots) can fill REQUIRED-FILL slots, leave section-level comments, and approve/return work in the browser instead of editing Markdown. Use when a brief or draft needs to go to a client/expert for review, or when building the briefs/index.html entry page for a client folder. The reviewer's input comes back as a JSON file that 04-content-brief Step 9 ingests. Visual quality is delegated to the frontend-design skill.
license
Recomby.ai — same terms as the recomby-geo plugin root LICENSE

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.

When to use

  • 04-content-brief Step 7 — emit briefs/<id>.html (fill-form) next to the .md.
  • 04-content-brief Step 9 — ingest the reviewer's returned *.feedback.json.
  • 05-production Step 7 — emit drafts/<id>.html (review form) next to the .md.
  • Whenever a client folder's briefs/index.html entry page needs (re)building.

Usage

bash
SK=plugins/recomby-geo/skills/geo-review-html

# Flavor A — fill-form HTML for a brief with REQUIRED-FILL slots
python3 $SK/scripts/render_html.py --mode brief \
  --md   clients/<slug>/briefs/<id>.md \
  --meta clients/<slug>/briefs/<id>.meta.json \
  --brand clients/<slug>/brand_context.json \
  --out  clients/<slug>/briefs/<id>.html

# Flavor B — review HTML for a publish-ready draft (section comments + approve)
python3 $SK/scripts/render_html.py --mode draft \
  --md   clients/<slug>/drafts/<id>.md \
  --meta clients/<slug>/drafts/<id>.meta.json \
  --brand clients/<slug>/brand_context.json \
  --out  clients/<slug>/drafts/<id>.html

# Entry page — one card per brief/draft, live progress, status tags
python3 $SK/scripts/render_html.py --mode index \
  --client-dir clients/<slug> \
  --brand clients/<slug>/brand_context.json \
  --out  clients/<slug>/briefs/index.html

Pure standard library — no install step. Output is a single self-contained .html (CSS + JS inlined) safe to email to a client; they double-click it.

Show full SKILL.md (220 more words)Show less

How it maps the inputs

  • brief mode splits the brief Markdown on REQUIRED-FILL · <id> · <type> blockquote blocks. Each becomes a yellow textarea with a <details> dropdown (what / why / bad example / good example). Everything else becomes a green "already-filled" prose block with its own 💬 comment toggle. The authoritative slot list is meta.json's slots[].
  • draft mode splits on ## headings so every section gets a comment toggle; the prose is rendered read-only with an ✓ Approve as-is action.
  • index mode scans briefs/ and drafts/ for *.meta.json, reading format, status, word_count, and slot fill counts. Live per-brief progress is read from each brief's localStorage when the page is opened.
  • --brand is optional. brand_name sets the client label; brand.primary_color (or brand_color) overrides the --accent CSS variable for light branding.

Returned feedback contract

Each HTML exports a JSON file matching schemas/review_feedback.schema.json:

json
{
  "brief_id": "free-cash-prize",
  "filled_at": "2026-06-07T14:30:00Z",
  "filled_by": "Jane Doe",
  "answers": { "data-1": "...", "quote-1": "..." },
  "comments": { "overall": "...", "filled-headline-finding": "..." },
  "status": "reviewed-with-comments"
}

status ∈ reviewed-with-comments | approved-as-is | partial-fill. The GEO operator feeds answers into the matching slots during 04-content-brief Step 9 (NEVER auto-filled by AI — the slots are the moat).

Hard rules

  1. Never auto-fill answers — the JSON carries the human's real input; that is the whole point. AI assembles, humans supply.
  2. Keep the interaction JS fixed — restyle CSS freely (frontend-design), but don't rewrite the localStorage/export/state-machine logic per run.
  3. Output stays self-contained — one file, no external CSS/JS, so a non-technical reviewer can open it from an email attachment.

© ViryaZheng, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in plugins/recomby-geo/skills/geo-review-html of ViryaZheng/recomby-geo.

  • SKILL.md
  • scripts/render_html.py
  • templates/review.html

Open the folder on GitHubat commit 530d5e2

Compare with similar skills

Geo Review HTML next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Geo Review HTML compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Geo Review HTML this skillViryaZheng/recomby-geo458—~1.3kAutomated safety check: PassMIT
BlogAgriciDaniel/claude-blog2.3k—~6.2kAutomated safety check: PassMIT
Blog BriefAgriciDaniel/claude-blog2.3k—~3.2kAutomated safety check: PassMIT
Blog BriefAgriciDaniel/claude-blog2.3k—~3.3kAutomated safety check: PassMIT
Blog BriefInfrasity-Labs/dev-gtm-claude-skills136—~2.8kAutomated safety check: PassMIT
Content BriefRyze-AI-Adgent/open-seo-mcp-skills4.7k—~610Automated safety check: PassMIT

Similar skills

  • Blog

    AgriciDaniel/claude-blog

    Full-lifecycle blog engine with 31 sub-skills, 12 templates, 100-point scoring, and 5 agents.

    2.3k GitHub stars~6.2k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Blog Brief

    AgriciDaniel/claude-blog

    Generate detailed content briefs for blog posts with target keywords, content outlines, competitive analysis, recommended statistics, image and chart suggestions, word count targets, internal…

    2.3k GitHub stars~3.2k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Blog Brief

    AgriciDaniel/claude-blog

    Generate detailed content briefs for blog posts with target keywords, content outlines, competitive analysis, recommended statistics, image and chart suggestions, word count targets, internal…

    2.3k GitHub stars~3.3k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Blog Brief

    Infrasity-Labs/dev-gtm-claude-skills

    Generate detailed content briefs for blog posts with target keywords, content outlines, competitive analysis, recommended statistics, image and chart suggestions, word count targets, internal…

    136 GitHub stars~2.8k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Content Brief

    Ryze-AI-Adgent/open-seo-mcp-skills

    SERP-driven content brief for a target keyword — what ranks, what to cover, headings, questions, internal links from your own data.

    4.7k GitHub stars~610 tokensUpdated 17 days ago
    Marketing & SEOAuto-check passed
  • Geo

    yaojingang/GEOHub

    Route GEO and generative engine optimization requests to an available GEOHub capability.

    165 GitHub stars~364 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from ViryaZheng/recomby-geo

  • Meta Tags Optimizer

    ViryaZheng/recomby-geo

    Optimize title tags, meta descriptions, Open Graph, and Twitter cards for maximum click-through rate.

    458 GitHub starsUsed in 1 repo~2.7k tokens
    Auto-check passed
  • Content Writer

    ViryaZheng/recomby-geo

    Write SEO-optimized blog posts, landing pages, and long-form page copy following Google's E-E-A-T and Helpful Content guidelines.

    458 GitHub stars~2.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Internal Linking Optimizer

    ViryaZheng/recomby-geo

    A skill your agent uses when improving internal link structure, anchor text, orphan pages, crawl depth, site architecture, or link equity flow.

    458 GitHub stars~2k tokensUpdated 3 mo ago
    Auto-check passed
  • Keyword Research

    ViryaZheng/recomby-geo

    Discover, analyze, and prioritize keywords for SEO and GEO content strategies.

    458 GitHub stars~2.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Content Quality Auditor

    ViryaZheng/recomby-geo

    A skill your agent uses when auditing content quality, E-E-A-T, publish readiness, or 内容质量/EEAT评分.

    458 GitHub stars~8k tokensUpdated 3 mo ago
    Auto-check passed
  • Geo Pipeline

    ViryaZheng/recomby-geo

    Entry point + orchestrator for the recomby-geo GEO (Generative Engine Optimization) workflow on OpenAI Codex CLI.

    458 GitHub stars~1.1k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Geo Review HTML

What does Geo Review HTML do?

Render an interactive, self-contained HTML companion for a GEO content brief (04-content-brief) or a publish-ready draft (05-production), so a NON-technical client reviewer (founder, organizer…. Geo Review HTML is an agent skill from ViryaZheng/recomby-geo. Render an interactive, self-contained HTML companion for a GEO content brief (04-content-brief) or a publish-ready draft (05-production), so a NON-technical client reviewer (founder, organizer staff, the domain expert filling slots) can fill REQUIRED-FILL slots, leave section-level comments, and approve/return work in the browser instead of editing Markdown.

When should I use Geo Review HTML?

Geo Review HTML fits situations like: draft needs to go to a client/expert for review; building the briefs/index.html entry page for a client folder.

How do I install Geo Review HTML in Claude Code?

Run `npx skills add ViryaZheng/recomby-geo --skill geo-review-html -a claude-code`. Or copy the skill folder (plugins/recomby-geo/skills/geo-review-html in ViryaZheng/recomby-geo) into .claude/skills/geo-review-html in your project. Claude Code loads it when a task matches its description.

How do I install Geo Review HTML in Codex?

Run `npx skills add ViryaZheng/recomby-geo --skill geo-review-html -a codex`. Or copy the skill folder (plugins/recomby-geo/skills/geo-review-html in ViryaZheng/recomby-geo) into .agents/skills/geo-review-html in your project. Codex loads it when a task matches its description.

Can I use Geo Review HTML in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ViryaZheng/recomby-geo --skill geo-review-html -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/geo-review-html, .gemini/skills/geo-review-html, .github/skills/geo-review-html and .opencode/skills/geo-review-html in your project.

What does Geo Review HTML need to run?

Going by SKILL.md and its folder, Geo Review HTML needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.

Does Geo Review HTML access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Geo Review HTML safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Geo Review HTML use?

Geo Review HTML is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Geo Review HTML use?

About 1.3k tokens (SKILL.md is roughly 5.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Geo Review HTML?

Skills that share tags, products or a category with Geo Review HTML: Blog (AgriciDaniel/claude-blog, 2.3k stars), Blog Brief (AgriciDaniel/claude-blog, 2.3k stars), Blog Brief (AgriciDaniel/claude-blog, 2.3k stars) and Blog Brief (Infrasity-Labs/dev-gtm-claude-skills, 136 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Geo Review HTML?

ViryaZheng (a GitHub user) maintains it in ViryaZheng/recomby-geo, which has 458 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on July 4, 2026.

Source: ViryaZheng/recomby-geo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.