Guide · Agent skill
How to use the GEO Technical SEO Audit agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The geo-technical skill is a set of written instructions that tells an AI agent, such as Claude, how to audit a website's technical SEO with checks aimed at AI search. Once installed, you can ask the agent to audit a site and it will fetch pages, follow a fixed checklist and write a report called GEO-TECHNICAL-AUDIT.md. This guide explains what the skill does, how to install it, how to trigger it and what to watch for before running it.
GEO Technical SEO Auditzubair-trabzada/geo-seo-claude · MIT Download the skill Quick start
- 1Download the skill ZIP. Get the ZIP for skills/geo-technical from the directory page.
- 2Unzip it into the skills folder. Place the folder in ~/.claude/skills/ for personal use or in .claude/skills/ inside a project.
- 3Or upload it in the Claude apps. Open Settings, go to Capabilities, then Skills, and upload the skill.
- 4Make sure the tools are available. Confirm the agent has shell access for curl and Bash and the WebFetch tool.
- 5Ask for an audit. Name the site you own and ask for a GEO technical SEO audit, optionally with a file name for the report.
- 6Review GEO-TECHNICAL-AUDIT.md. Read the scores and fix the failed checks, starting with AI crawler access in robots.txt.
What is an agent skill and what does this one do?
An agent skill is a folder containing a SKILL.md file. The file tells an AI agent when to use the skill and how to carry out a task step by step. This skill lives in the geo-seo-claude repository under skills/geo-technical and is released under the MIT licence.
When the skill is active, the agent collects the target URL along with the homepage and two or three key inner pages. It fetches each page to read the raw HTML and HTTP headers, runs through the audit categories, scores each one against a point rubric and saves the results to GEO-TECHNICAL-AUDIT.md.
- Crawlability (15 points): robots.txt validity, AI crawler access, XML sitemaps, crawl depth within 3 clicks and noindex directives
- Indexability (12 points): canonical tags, duplicate content such as www versus non-www and HTTP versus HTTPS, pagination, hreflang and index bloat
- Security (10 points): HTTPS enforcement, HSTS and other security headers
- URL structure (8 points): clean URLs, logical hierarchy and redirect chains
How do you install the geo-technical skill?
Download the ZIP for the skill from the directory page. Unzip it into your personal skills folder, ~/.claude/skills/, or into a project's .claude/skills/ folder if you want the skill to apply only to that project.
If you use the Claude apps instead, open Settings, go to Capabilities, then Skills, and upload the skill there.
- Personal install: place the unzipped folder inside ~/.claude/skills/
- Project install: place the unzipped folder inside .claude/skills/ in your project
- Claude apps: Settings, then Capabilities, then Skills, then upload
~/.claude/skills/How do you trigger the skill with a normal request?
You do not need a special command. Describe the task in plain language and name the site you want audited. The agent should recognise a technical SEO or GEO audit request and use the skill. If it does not, name the skill directly in your request.
Useful requests include asking whether AI crawlers can reach a site, asking for a robots.txt check, or asking for a full technical audit report saved to a file.
- Run a GEO technical SEO audit on example.com and save the report
- Check whether my robots.txt blocks GPTBot or PerplexityBot on example.com
- Check the security headers and HTTPS setup for example.com
- Use the geo-technical skill to audit the URL structure of example.com
What does the agent check and how is it scored?
The most important GEO check is AI crawler access. The skill looks in robots.txt for rules that target crawlers including GPTBot, PerplexityBot, ClaudeBot, Google-Extended, Googlebot and Bingbot. Blocking Google-Extended does not block Googlebot, because Google-Extended only controls use of content for AI training. The skill still recommends allowing it unless there is a specific data licensing concern.
Scoring for AI crawler access runs from 5 points when all major AI crawlers are allowed, down to 0 points when Googlebot is blocked, which the skill treats as fatal. Other checks use simple pass or fail points listed in each category's table.
- All major AI crawlers allowed: 5 points
- Some blocked but Googlebot and Bingbot allowed: 3 points
- GPTBot or PerplexityBot blocked: 1 point
- Googlebot blocked: 0 points
What do you need before running an audit?
The skill needs an agent environment that can run shell commands, since its instructions use curl and Bash, and it needs the WebFetch tool. Its allowed-tools list also includes Read, Grep, Glob and Write, so the agent can read files and save the report. The file does not mention any API keys or accounts.
The skill runs scripts and uses the network, because it fetches live pages and checks their headers. Results depend on what the site returns at the time of the test.
- Shell access for curl and Bash
- WebFetch tool
- Write access to save GEO-TECHNICAL-AUDIT.md
- No API keys or accounts are mentioned in the file
What should you keep in mind before running it?
Only audit sites you own or have permission to test. The skill fetches pages and checks headers, and the site owner may treat that as unwelcome scanning. Also keep in mind that the scoring rubric is a heuristic checklist. A high score does not guarantee that an AI assistant will read or cite your pages, and the skill does not measure actual AI search results.
The file as provided covers crawlability, indexability, security and URL structure. It describes eight categories in total, but the text shown is cut off after the URL structure section, so the performance, server-side rendering and other remaining checks are not visible in this copy of the file.
- Test only sites you own or have permission to check
- Treat the score as a checklist result, not a ranking forecast
- Note that the source text shown does not include the last categories
What people use it for
- Checking whether robots.txt blocks GPTBot, PerplexityBot or ClaudeBot before a site launch
- Preparing a technical SEO audit report for a client that includes robots.txt, sitemap and canonical findings
- Reviewing HTTPS redirects, HSTS and other security headers on a staging or live site you manage
- Finding redirect chains and parameter-based duplicate URLs during a site migration check
Frequently asked questions
Is the geo-technical skill free to use?
The skill is released under the MIT licence, as stated on the directory page. The file itself does not mention any price or paid account requirement.
How do I install the geo-technical agent skill?
Download the ZIP for the skill from the directory page and unzip it into ~/.claude/skills/ for personal use or into .claude/skills/ in a project. In the Claude apps you can instead upload it under Settings, Capabilities, Skills.
What does the skill need to run?
It needs shell access for curl and Bash and the WebFetch tool, as listed in its allowed-tools field. The file does not mention API keys or accounts.
Does the skill check whether AI crawlers can access my site?
Yes. It checks robots.txt for rules that target crawlers such as GPTBot, PerplexityBot, ClaudeBot and Google-Extended, and scores AI crawler access from 5 points down to 0 points.
Will a high audit score get my site cited by AI assistants?
No. The rubric is a heuristic checklist and does not measure actual AI search results. It can show technical blockers, but it cannot guarantee ranking or citation.
Is it safe to run the skill on someone else's website?
Only test sites you own or have permission to test. The skill fetches pages and checks headers, which the site owner may consider unwelcome scanning.
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
This skill suits website owners, SEO specialists and developers who want a repeatable checklist for robots.txt, AI crawler access, indexability, security headers and URL structure on sites they control. It is not a substitute for real AI search measurement, and people who need guaranteed results or want to audit sites they have no permission to test should choose a different approach.
Download the skill