Geo report pdf

Skill nota-america/forgecat-agent-profiles/profiles/zubair-trabzada/geo-seo-claude/for-forgecat/skills/geo-report-pdf

Production-ready AI agent profiles for Claude Code, Cursor, and Codex. Search, install, and contribute ForgeCat packages.

Install

npx -y skills add nota-america/forgecat-agent-profiles --skill geo-report-pdf

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

24 stars24 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Generate a professional PDF report from a GEO audit using pandoc + Chrome headless. Converts GEO-AUDIT-REPORT.md into a styled, client-ready PDF with a cover page, color-coded score tables, severity-tagged findings, and a 90-day roadmap.

SKILL.md

5.0 KB, as published. Nobody here has run it

GEO PDF Report Generator (pandoc pipeline)

Prerequisites

pandoc — brew install pandoc
Google Chrome — must be installed at /Applications/Google Chrome.app/

No Python dependencies. No ReportLab. No JSON data wrangling.

How It Works

Read GEO-AUDIT-REPORT.md in the current directory (created by /geo audit)
Extract cover metadata from the report (brand name, domain, GEO score, date, locations)
Run pandoc with the bundled CSS + HTML template to produce a self-contained GEO-REPORT.html
Run Chrome headless to print the HTML to GEO-REPORT.pdf

The pandoc template (~/.claude/skills/geo/templates/geo-report-template.html) injects:

A full-bleed dark navy cover section with the GEO score badge
Per-section cover metadata (date, business type, locations, platform)
JavaScript that runs inside Chrome before printing to color-code score cells and severity-tag finding sections

Workflow

Step 1: Check for audit report

Look for GEO-AUDIT-REPORT.md in the current directory. If absent, tell the user to run /geo audit <url> first.

Step 2: Extract cover metadata from the report

Read the top of GEO-AUDIT-REPORT.md and extract:

Field	Where to find it
`brand_name`	First H1 title (after "GEO Audit Report:")
`domain`	Second bold line (e.g. `Domain: alexamediasolutions.com`)
`geo_score`	Line matching `## Overall GEO Score: XX / 100`
`score_label`	Word after the score on that same line (e.g. "Poor", "Fair", "Good")
`date`	`Audit Date:` line
`business_type`	`Business Type:` line
`locations`	`Locations:` line
`platform`	`CMS:` line

Step 3: Run pandoc

pandoc GEO-AUDIT-REPORT.md \
  --to html5 \
  --standalone \
  --embed-resources \
  --template ~/.claude/skills/geo/templates/geo-report-template.html \
  --css ~/.claude/skills/geo/templates/geo-report-style.css \
  --metadata title="GEO Audit Report — <brand_name>" \
  --metadata brand_name="<brand_name>" \
  --metadata domain="<domain>" \
  --metadata geo_score="<geo_score>" \
  --metadata score_label="<score_label>" \
  --metadata date="<date>" \
  --metadata business_type="<business_type>" \
  --metadata locations="<locations>" \
  --metadata platform="<platform>" \
  -o GEO-REPORT.html

Replace <field> placeholders with values extracted in Step 2. If a field is not found in the report, omit that --metadata flag — the template has sensible defaults.

Step 4: Run Chrome headless

"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
  --headless=new \
  --disable-gpu \
  --no-sandbox \
  --print-to-pdf="$(pwd)/GEO-REPORT.pdf" \
  --print-to-pdf-no-header \
  --no-pdf-header-footer \
  --virtual-time-budget=5000 \
  "file://$(pwd)/GEO-REPORT.html"

Step 5: Report completion

Tell the user:

GEO-REPORT.pdf was generated in the current directory
File size
Optionally: open GEO-REPORT.pdf to preview it

What the PDF Contains

Cover page — Dark navy gradient, brand name, domain, GEO score badge (colored by score), audit date, business type, locations, CMS platform
Score tables — Cells containing XX/100 are color-coded: ≥80 green, ≥65 blue, ≥50 amber, ≥35 orange, <35 red
Finding sections — h3 headings containing "Critical / High / Medium / Low" get severity-colored left-border callout blocks (red / orange / yellow / green)
Section page breaks — Major sections (High Priority, 90-Day Roadmap, Component Score Summary, Generated Schema) break to new pages automatically
Code blocks — JSON schema templates render with dark theme monospace styling
Page footer — Brand name · GEO Audit · date + page numbers (via CSS @page)

Customizing the Report

Colors / typography — Edit ~/.claude/skills/geo/templates/geo-report-style.css
Cover layout — Edit ~/.claude/skills/geo/templates/geo-report-template.html
Score thresholds for color-coding — Edit the scoreColor() function in the template's <script> block
Which sections get page breaks — Edit the breakBefore array in the template's <script> block

Troubleshooting

Problem	Fix
`pandoc: command not found`	`brew install pandoc`
Chrome not found	Check path: `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`
PDF is blank / empty	Increase `--virtual-time-budget` to 8000
Cover metadata missing	Check GEO-AUDIT-REPORT.md has the standard header format
Fonts not loading	PDF is rendered offline; system fonts are used as fallback — this is expected