Guide · Agent skill
How to use the GEO Client Report Generator agent skill (geo-report)
Updated · written with AI from the project's own documentation and checked against our catalogue data
The geo-report skill is an instruction file that tells an AI agent, such as Claude Code, how to combine the results of several website AI-search audits into one client-facing report. It is written for agencies, freelancers and marketing leaders who need a non-technical summary of how visible a site is to AI answer engines. After this guide you will know what the skill does, how to install it, how to ask for a report in plain language, and what it needs before you run it.
Quick start
- 1Download and unzip the skill. Download the geo-report ZIP from this page and unzip it so you have a folder containing SKILL.md.
- 2Place the folder. Copy the geo-report folder into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder for one project. In the Claude apps, upload it under Settings → Capabilities → Skills.
- 3Run the required audits. Run geo-platform-optimizer, geo-schema, geo-technical and geo-content so each produces its report file.
- 4Make a natural request. Ask the agent in plain language to create a GEO client report using the existing audit files.
- 5Review the output. Open GEO-CLIENT-REPORT.md and check each score against its source audit file.
- 6Edit and deliver. Remove any unsupported traffic or revenue estimates, adjust the wording and send the report to your client.
What the geo-report skill makes the agent do
The skill aggregates the outputs of other GEO audit skills into a single deliverable called GEO-CLIENT-REPORT.md. It translates technical findings into business impact and prioritized action items for a business owner rather than a developer.
The agent calculates a composite GEO Readiness Score from five weighted components: AI Platform Readiness (25%), Content Quality and E-E-A-T (25%), Technical Foundation (20%), Schema and Structured Data (15%) and Brand Authority and Entity Presence (15%). The score is rounded to the nearest integer and capped at 100, and it is labelled from Excellent (85-100) down to Needs Attention (0-39).
- Executive summary: one paragraph covering the domain analysed, the overall score and the top priorities.
- Per-platform visibility for Google AI Overviews, ChatGPT Web Search, Perplexity AI, Google Gemini and Bing Copilot.
- AI crawler access status for crawlers such as Googlebot, GPTBot, Bingbot, PerplexityBot, ClaudeBot and Applebot-Extended.
- Brand authority across platforms such as Wikipedia, Wikidata, LinkedIn, YouTube, Reddit and Crunchbase.
- Citability analysis of the most and least citable pages, and a technical health summary.
Install the geo-report skill from the ZIP
Download the ZIP for the skill from this page and unzip it. The skill is a folder that contains SKILL.md. Place that folder in one of two locations, depending on how you want to use it.
For all of your projects, put it in your personal skills folder at ~/.claude/skills/. To use it only inside one project, put it in that project's .claude/skills/ folder. If you use the Claude apps instead of Claude Code, you can upload the skill under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/geo-report/ (available across projects).
- Project install: .claude/skills/geo-report/ inside your project folder (available only there).
- Claude apps: Settings → Capabilities → Skills, then upload the skill.
~/.claude/skills/geo-report/SKILL.mdRun the underlying audits before you ask for a report
The report depends on the output files of other skills. Run these first, or supply existing report data. The skill expects each audit to write a specific file.
The four required audits are geo-platform-optimizer (GEO-PLATFORM-OPTIMIZATION.md), geo-schema (GEO-SCHEMA-REPORT.md), geo-technical (GEO-TECHNICAL-AUDIT.md) and geo-content (GEO-CONTENT-ANALYSIS.md). The optional inputs are geo-llmstxt (an llms.txt assessment) and geo-brand-mentions (brand authority data).
If the underlying audits have not been run, do not use this skill. The scores depend on their outputs and can be invented or inaccurate without them.
- Required: geo-platform-optimizer, geo-schema, geo-technical, geo-content.
- Optional: geo-llmstxt, geo-brand-mentions.
- The skill's output file is GEO-CLIENT-REPORT.md.
Trigger the skill with a natural request
You do not need a special command. Describe what you want in plain language and mention the client report or the audit results. Agents load a skill when the request matches its description, which covers generating a professional, client-facing GEO report with scores, findings and prioritized actions.
Make the request specific about the site and the files. This helps the agent find the audit outputs in your project folder.
- "Use the geo-report skill to combine the audit files in this folder into a client report."
- "Create a GEO client report for example.com with scores, findings and priority actions."
- "Write the executive summary and GEO Readiness Score for the client using the existing audit reports."
Read the report and check it before you send it
The report follows a fixed template: executive summary, GEO Readiness Score table, AI Visibility Dashboard, AI Crawler Access, Brand Authority, Citability Analysis, Technical Health and further sections. Each section is written in a client-friendly tone.
Before you deliver it, check the numbers against the underlying audit files. The template asks for estimated traffic and revenue impact figures, which the skill does not ground in real analytics, so remove or label any such estimate that you cannot support.
- Compare each component score with its source audit file.
- Confirm the crawler status rows match your robots.txt and server settings.
- Remove or qualify any estimated percentage or dollar impact figure.
Safety notes: scripts and network access
According to the skill's listing, it does not run scripts. It does use the network: its allowed tools include WebFetch and Bash, so check what the agent does during a run, and review the files it reads and writes.
The skill writes its report to a Markdown file in your working area. Review the output before sharing it with a client, because the agent generates the wording from the audit data it reads.
- Scripts: none, according to the listing.
- Network: yes. The skill's allowed tools include WebFetch.
- Files it writes: GEO-CLIENT-REPORT.md.
Tips for better client reports
Run all four required audits on the same version of the site so the scores describe the same pages. Keep the audit files in one folder so the agent reads a consistent set of inputs.
If a component is missing, say so in the report rather than estimating it. A clear gap is more useful to a client than an invented score.
- Use the same site snapshot for every audit.
- Include the optional geo-llmstxt and geo-brand-mentions audits when you have them.
- Edit the wording into your own voice before sending the report.
What people use it for
- An agency delivering a GEO audit to a client as a single PDF-ready Markdown report.
- A freelancer summarising AI-search visibility for a business owner who does not read technical audits.
- A marketing lead who ran the geo-* audits and needs one document for a quarterly review.
- A team comparing component scores across audit runs to show progress on priority actions.
Frequently asked questions
How do I install the geo-report skill?
Download the ZIP from this page and unzip it. Place the geo-report folder in ~/.claude/skills/ for personal use or in a project's .claude/skills/ folder for one project. In the Claude apps, upload it under Settings → Capabilities → Skills.
What do I need before using geo-report?
You need Claude Code or another agent that can read and write files, plus the output files from the related geo-* audits. The required audits are geo-platform-optimizer, geo-schema, geo-technical and geo-content, with geo-llmstxt and geo-brand-mentions as optional inputs.
Is geo-report free to use?
The skill is released under the MIT licence, as listed on this page. Check the licence file in the source repository for the full terms before you use it commercially.
Can geo-report run without the other audit skills?
The skill is designed to work from the report files those audits produce, or from existing report data. Without the underlying audits the scores can be invented or inaccurate, so the skill is not suitable in that case.
Why does the report mention traffic or revenue estimates?
The template asks for estimated percentage and dollar impact figures. The skill does not ground these in real analytics, so treat them as unverified and remove them unless you can support them with your own data.
How is the GEO Readiness Score calculated?
It is a weighted average: platform readiness 25%, content quality 25%, technical foundation 20%, schema 15% and brand authority 15%. The result is rounded to the nearest integer and capped at 100.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use geo-report if you are an agency, freelancer or marketing lead who has already run the geo-* audits and needs one clear client deliverable. Pick something else if you have not run the audits, because the scores depend on them, or if you need verified traffic or revenue forecasts, which this skill does not provide.
Download the skill