geo-report-pdf

Convert GEO audit Markdown reports into styled PDF documents using pandoc and Chrome headless.

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/finedesignz/geo-seo-claude --skill geo-report-pdf-finedesignz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: geo-report-pdf
Source: https://github.com/finedesignz/geo-seo-claude/tree/main/skills/geo-report-pdf
Command: npx skills add https://github.com/finedesignz/geo-seo-claude --skill geo-report-pdf-finedesignz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a raw GEO audit Markdown report into a polished, client-ready PDF normally requires manual formatting work. This Skill automates the conversion of GEO-AUDIT-REPORT.md into a styled PDF with a cover page, color-coded score tables, and severity-tagged findings. ## Core Features & Use Cases - Automated PDF Generation: Converts GEO-AUDIT-REPORT.md into GEO-REPORT.pdf via pandoc and Chrome headless with no Python dependencies. - Styled Client Deliverable: Injects a dark navy cover page with GEO score badge, color-codes score cells by threshold, and adds severity-colored callouts for Critical/High/Medium/Low findings. - Use Case: After running /geo audit on a client website, generate a branded PDF report with a 90-day roadmap and schema code blocks to deliver directly to the client. ## Quick Start Generate a PDF report from the GEO-AUDIT-REPORT.md file in the current directory.

Frequently Asked Questions about geo-report-pdf

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a Markdown audit report to PDF?▼

Run pandoc on the Markdown file with an HTML template and CSS to produce a styled HTML file, then print it to PDF using Chrome headless with the --print-to-pdf flag. This Skill automates both commands for GEO-AUDIT-REPORT.md.

How to generate a PDF from HTML using Chrome headless?▼

Invoke Chrome with --headless=new, --print-to-pdf, and --no-pdf-header-footer flags pointing at the HTML file. The --virtual-time-budget flag gives embedded JavaScript time to run before printing.

What dependencies are needed for pandoc PDF generation?▼

This workflow requires pandoc (installable via brew install pandoc) and Google Chrome installed at /Applications/Google Chrome.app/. No Python packages or ReportLab are needed.

Why is my Chrome headless PDF blank or empty?▼

A blank PDF usually means the page's JavaScript did not finish executing before printing. Increase the --virtual-time-budget value from 5000 to 8000 to give the rendering scripts more time.

Can I customize the colors and layout of the PDF report?▼

Yes. Edit geo-report-style.css for colors and typography, geo-report-template.html for the cover layout, and the template's script block for score color thresholds and page-break sections.