Install It Now
npx skills add johnakande/agentic-ai-seo-skill --global
On Claude Code 2.1.142 or newer, install it as a plugin instead:
/plugin marketplace add johnakande/agentic-ai-seo-skill
/plugin install agentic-ai-seo-skill@agentic-ai-seo-skill
What It Does
Agentic AI-SEO Skill is a free, open-source, LLM-first SEO analysis skill. One orchestrator command routes to 24 sub-skills covering technical SEO, schema markup, content quality (E-E-A-T), AI search optimisation (GEO and AEO), local SEO, and GitHub repository SEO. It is plain Markdown with YAML frontmatter and no host-specific installer, so it works the same whether it is loaded by Claude Code, Codex, Antigravity, or any other agent that reads a SKILL.md file and runs shell commands.
For a full audit, the orchestrator detects your business type from homepage signals (SaaS, local service, ecommerce, publisher, or agency), works through the relevant specialists in sequence, and synthesises findings through a perceive-analyse-validate-act framework before handing back a prioritised action plan. Every recommendation states the observation it rests on and a leading indicator to watch, instead of a generic "improve your SEO" checklist copy-pasted for every site. It is the same skill running under the hood for the audit work behind johnakande.com's own SEO.
Work With John
Your site should be your best salesperson. If it is not, that is a fixable problem.
I work with US service businesses and B2B brands to build SEO systems that produce consistent, compounding leads. I will tell you exactly what is broken. No pitch.
Book a free strategy callHow to Use It
Step 1: Install. Run the command above.
Step 2: Run a full audit. /agentic-ai-seo-skill audit https://example.com. Or ask in plain language, "audit example.com's technical SEO," and it runs the same way.
Step 3: Or skip to one category. /agentic-ai-seo-skill technical, schema, content, geo, aeo, local, backlinks, github, and more, each one going straight to that specialist instead of the full multi-pass audit.
Step 4: Act on the output. Every finding comes with the evidence behind it, so you or a developer can verify the issue before fixing it.
Key Features
24 specialised sub-skills under one orchestrator, covering technical SEO, schema, content and E-E-A-T, sitemap, images, GEO, AEO, local SEO, hreflang, ecommerce SEO, backlinks, keyword clustering, and GitHub repo SEO, so one install covers most of what a paid audit tool charges for separately.
Business-type detection. The orchestrator reads homepage signals to classify a site as SaaS, local service, ecommerce, publisher, or agency, then routes to the specialists relevant to that business type instead of running every check on every site.
Evidence-tied recommendations. Every finding states the observation it rests on and a leading indicator to monitor, so you are not left guessing whether a suggestion is generic advice or specific to your site.
GitHub repository SEO. A dedicated command audits a repo's README, topics, and community health signals, not just the website.
No isolated environment or Chromium download required, just the bundled scripts and whatever Python you already have, 3.10 or newer.
Use Cases
Running a full technical, content, and schema audit on a client site or your own before a redesign, instead of piecing together five separate tools. Auditing a GitHub repo's discoverability, README, topics, and community health, alongside the website that promotes it. Checking AI Overview and featured-snippet readiness (GEO and AEO) on pages built before AI search existed as a ranking surface. Generating a content brief, keywords, outline, and internal links, before writing a single word of a new page. Running a lighter single-category check, schema, sitemap, or images, when a full audit is more than you need.
Best Fit
- You use Claude Code, OpenCode, or another agent that reads SKILL.md files and want a real audit grounded in evidence, not a generic checklist.
- You maintain a GitHub repository and want its discoverability audited alongside your website.
- You want AI search readiness, GEO and AEO, checked as a first-class category, not an afterthought bolted onto a legacy SEO tool.
Not a Fit
- You are on Cursor, Windsurf, Continue.dev, or GitHub Copilot without adapting the skill format first. It is built natively for Claude Code and OpenCode; other hosts read a different rule format and need real adaptation work, not a straight copy.
- You want a tool that automatically fixes issues for you. This is a diagnostic: it tells you what is wrong, why, and how to fix it. Implementing the fix is still on you or your developer.
Requirements
Free and open source under the MIT license. Python 3.10 or newer for the bundled scripts. No isolated environment or browser download needed.
If you would rather have this run for you than run it yourself, our technical SEO service uses the same evidence-first methodology on a fully managed basis.
