Harness Book Best Practice
wquguru/harness-books
Best practices for working on the Harness books repo. An agent skill from wquguru/harness-books.
Generate a professional PDF report from a GEO audit using pandoc + Chrome headless.
Install Geo Report PDF
$ npx skills add zubair-trabzada/geo-seo-claude --skill geo-report-pdf -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install zubair-trabzada/geo-seo-claude geo-report-pdf --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/zubair-trabzada/geo-seo-claude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/geo-report-pdf .claude/skills/geo-report-pdf && rm -rf skills-srcUse ~/.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/
Install the "geo-report-pdf" agent skill from https://github.com/zubair-trabzada/geo-seo-claude/tree/main/skills/geo-report-pdf into .claude/skills/geo-report-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-report-pdf", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/zubair-trabzada/geo-seo-claude/tree/main/skills/geo-report-pdfType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add zubair-trabzada/geo-seo-claude --skill geo-report-pdf -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install zubair-trabzada/geo-seo-claude geo-report-pdf --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zubair-trabzada/geo-seo-claude.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/geo-report-pdf .agents/skills/geo-report-pdf && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "geo-report-pdf" agent skill from https://github.com/zubair-trabzada/geo-seo-claude/tree/main/skills/geo-report-pdf into .agents/skills/geo-report-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-report-pdf", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add zubair-trabzada/geo-seo-claude --skill geo-report-pdf -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install zubair-trabzada/geo-seo-claude geo-report-pdf --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zubair-trabzada/geo-seo-claude.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/geo-report-pdf .cursor/skills/geo-report-pdf && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "geo-report-pdf" agent skill from https://github.com/zubair-trabzada/geo-seo-claude/tree/main/skills/geo-report-pdf into .cursor/skills/geo-report-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-report-pdf", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/zubair-trabzada/geo-seo-claude.git --path skills/geo-report-pdf--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add zubair-trabzada/geo-seo-claude --skill geo-report-pdf -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install zubair-trabzada/geo-seo-claude geo-report-pdf --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zubair-trabzada/geo-seo-claude.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/geo-report-pdf .gemini/skills/geo-report-pdf && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "geo-report-pdf" agent skill from https://github.com/zubair-trabzada/geo-seo-claude/tree/main/skills/geo-report-pdf into .gemini/skills/geo-report-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-report-pdf", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install zubair-trabzada/geo-seo-claude geo-report-pdfInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add zubair-trabzada/geo-seo-claude --skill geo-report-pdf -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/zubair-trabzada/geo-seo-claude.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/geo-report-pdf .github/skills/geo-report-pdf && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "geo-report-pdf" agent skill from https://github.com/zubair-trabzada/geo-seo-claude/tree/main/skills/geo-report-pdf into .github/skills/geo-report-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-report-pdf", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add zubair-trabzada/geo-seo-claude --skill geo-report-pdf -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install zubair-trabzada/geo-seo-claude geo-report-pdf --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zubair-trabzada/geo-seo-claude.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/geo-report-pdf .opencode/skills/geo-report-pdf && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "geo-report-pdf" agent skill from https://github.com/zubair-trabzada/geo-seo-claude/tree/main/skills/geo-report-pdf into .opencode/skills/geo-report-pdf/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "geo-report-pdf", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
geo-report-pdf- GitHub stars
- 11k
- Token cost
- ~1.3k tokens
- SKILL.md length
- 464 words
- Files
- 1
- Skills in repo
- 16
- Repo updated
- First seen
- Licence
- MIT
At a glance
Generate a professional PDF report from a GEO audit using pandoc + Chrome headless.
- Works in 5 steps: Check for audit report → Extract cover metadata from the report → Run pandoc → …
- Tasks that involve PDF
- SKILL.md covers Prerequisites, How It Works, Workflow and What the PDF Contains, plus 2 more sections
- Calls brew and pandoc
What it does
Geo Report PDF is an agent skill from zubair-trabzada/geo-seo-claude. 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.
Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office, covering PDF and AI search optimization. It works with Pandoc. The repository describes itself as: GEO-first SEO skill for Claude Code. Comprehensive AI search optimization for any website — citability scoring, AI crawler analysis, brand authority, schema markup…. The licence is MIT.
When your agent uses it
- Tasks that involve PDF
- Tasks that involve AI search optimization
Example prompts
- “/geo-report-pdf”
Requirements
- Python 3
- Pre-approved tools (allowed-tools): Read, Grep, Glob, Bash, Write
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 989cae0. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
ReadGrepGlobBashWrite
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
brewpandoc
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 Report PDF loads about 1.3k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 464 words of instructions outside code blocks.
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: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Read, Grep, Glob, Bash, Write
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); files beside SKILL.md are not scanned.
SKILL.md
The full file from zubair-trabzada/geo-seo-claude at commit 989cae0, republished under its MIT licence (© zubair-trabzada). 464 words, ~1,264 tokens.
Download SKILL.mdSave it as
.claude/skills/geo-report-pdf/SKILL.md (or your agent's skills folder).- name
- geo-report-pdf
- description
- 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.
- allowed-tools
- Read, Grep, Glob, Bash, Write
- version
- 2.0.0
- author
- geo-seo-claude
- tags
- geo, pdf, report, client-deliverable, professional
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.mdin the current directory (created by/geo audit) - Extract cover metadata from the report (brand name, domain, GEO score, date, locations)
- Run
pandocwith the bundled CSS + HTML template to produce a self-containedGEO-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.htmlReplace <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.pdfwas generated in the current directory- File size
- Optionally:
open GEO-REPORT.pdfto preview it
Show full SKILL.md (192 more words)Show less
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/100are color-coded: ≥80 green, ≥65 blue, ≥50 amber, ≥35 orange, <35 red - Finding sections —
h3headings 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
breakBeforearray 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 |
© zubair-trabzada, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/geo-report-pdf of zubair-trabzada/geo-seo-claude.
Open the folder on GitHubat commit 989cae0
Compare with similar skills
Geo Report PDF 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Geo Report PDF this skillzubair-trabzada/geo-seo-claude | 11k | — | ~1.3k | Automated safety check: Notes | MIT | |
| Harness Book Best Practicewquguru/harness-books | 3.2k | — | ~4.1k | Automated safety check: Pass | None | |
| Huashu Markdown Publishing Pipelinealchaincyf/huashu-md-html | 910 | — | ~4.8k | Automated safety check: Pass | MIT | |
| Pandic OfficeTeam-Commonly/commonly | 1.4k | — | ~642 | Automated safety check: Pass | Apache-2.0 | |
| PDFguyi-a/pi-ling | 106 | — | ~3.3k | Automated safety check: Pass | MIT | |
| Doc To Markdowndaymade/claude-code-skills | 1.5k | — | ~2.5k | Automated safety check: Pass | MIT |
Similar skills
Huashu Markdown Publishing Pipeline
alchaincyf/huashu-md-html
Converts files and web pages into clean Markdown, then turns Markdown into polished HTML, Word, PDF and EPUB using four templates.
Pandic Office
Team-Commonly/commonly
Convert Markdown to PDF (or DOCX/EPUB/HTML) using the pandoc CLI.
PDF
guyi-a/pi-ling
PDF 相关的所有操作：从零生成（reportlab / pypdf）、格式转化（md/html → PDF）、修改（合并 / 拆分 / 旋转 / 加水印 / 提图片 / 元数据）、读内容（pdfplumber / extractdocumenttext）、OCR 扫描件、加密解密。触发场景：用户说"生成 PDF" / "做份 PDF 简历" / "合并这几份 PDF" / "给 PDF…
Doc To Markdown
daymade/claude-code-skills
Converts DOCX/PDF/PPTX and saved HTML/HTM to high-quality Markdown with automatic post-processing.
Md To PDF
hamzafarooq/claude-code-starter
Convert any markdown file to a clean PDF. An agent skill from hamzafarooq/claude-code-starter.
More from zubair-trabzada/geo-seo-claude
All 16 skills in this repoGEO-First SEO Audit Tool
zubair-trabzada/geo-seo-claude
Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.
GEO Monthly Delta Report
zubair-trabzada/geo-seo-claude
Compares a baseline and a current GEO audit for a client, calculates score changes and action item progress, and writes a monthly progress report.
AI Citability Scorer
zubair-trabzada/geo-seo-claude
Scores how likely AI assistants are to quote passages from a web page and suggests rewrites that make those passages easier to extract.
GEO Service Proposal Generator
zubair-trabzada/geo-seo-claude
Builds a client-ready AI-search-optimization proposal from an existing GEO audit, with pricing tiers, an ROI estimate and a markdown document ready to send.
GEO Content E-E-A-T Scorer
zubair-trabzada/geo-seo-claude
Scores a page's content against Google's E-E-A-T framework and AI-citability structure, then writes a scored gap-analysis report.
GEO Prospect Tracker
zubair-trabzada/geo-seo-claude
Tracks GEO agency leads and clients through a sales pipeline in a local JSON file, with notes, audit scores, deal values and a pipeline summary.
Related
Works with
Categories
Questions about Geo Report PDF
What does Geo Report PDF do?
Generate a professional PDF report from a GEO audit using pandoc + Chrome headless. Geo Report PDF is an agent skill from zubair-trabzada/geo-seo-claude. Generate a professional PDF report from a GEO audit using pandoc + Chrome headless.
When should I use Geo Report PDF?
Geo Report PDF fits situations like: tasks that involve PDF; tasks that involve AI search optimization.
How do I install Geo Report PDF in Claude Code?
Run `npx skills add zubair-trabzada/geo-seo-claude --skill geo-report-pdf -a claude-code`. Or copy the skill folder (skills/geo-report-pdf in zubair-trabzada/geo-seo-claude) into .claude/skills/geo-report-pdf in your project. Claude Code loads it when a task matches its description.
How do I install Geo Report PDF in Codex?
Run `npx skills add zubair-trabzada/geo-seo-claude --skill geo-report-pdf -a codex`. Or copy the skill folder (skills/geo-report-pdf in zubair-trabzada/geo-seo-claude) into .agents/skills/geo-report-pdf in your project. Codex loads it when a task matches its description.
Can I use Geo Report PDF 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 zubair-trabzada/geo-seo-claude --skill geo-report-pdf -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-report-pdf, .gemini/skills/geo-report-pdf, .github/skills/geo-report-pdf and .opencode/skills/geo-report-pdf in your project.
What does Geo Report PDF need to run?
Going by SKILL.md and its folder, Geo Report PDF needs the command-line tools its instructions call (brew and pandoc). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Grep, Glob, Bash, Write.
Does Geo Report PDF 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 Report PDF safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Geo Report PDF use?
Geo Report PDF 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 Report PDF use?
About 1.3k tokens (SKILL.md is roughly 5.1k 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 Report PDF?
Skills that share tags, products or a category with Geo Report PDF: Harness Book Best Practice (wquguru/harness-books, 3.2k stars), Huashu Markdown Publishing Pipeline (alchaincyf/huashu-md-html, 910 stars), Pandic Office (Team-Commonly/commonly, 1.4k stars) and PDF (guyi-a/pi-ling, 106 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Geo Report PDF?
zubair-trabzada (a GitHub user) maintains it in zubair-trabzada/geo-seo-claude, which has 10,982 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 10, 2026.
Source: zubair-trabzada/geo-seo-claude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.