Web Quality SEO: Claude Code Skill & Agent Tool
An open-source skill by addyosmani (opens in a new tab), published in the addyosmani/web-quality-skills (opens in a new tab) repository on GitHub. Evidence-led technical SEO from Addy Osmani's web quality skills: robots.txt, sitemaps, meta tags, canonical URLs and structured data, with concrete code fixes for each finding.
Install seo
Requires Node.jsnpx skills add addyosmani/web-quality-skills --skill seoRun this command in your project terminal to install this skill for Claude Code.
What this skill does
This seo skill belongs to web-quality-skills, the collection Addy Osmani maintains around Lighthouse and modern web standards. It activates when you ask your agent to improve SEO, fix meta tags, add structured data or optimize a sitemap, and it follows an evidence-led audit workflow: every recommendation is grounded in what the agent actually observes in the page, the response headers or the code.
On the technical side it covers crawlability and robots.txt — including the rule never to block resources needed for rendering — XML sitemaps, canonical URLs, URL structure and HTTPS. On-page, it reviews title tags, meta descriptions, heading hierarchy, image SEO and internal linking, and it provides ready-to-adapt JSON-LD for structured data. It also addresses newer questions: AI crawler controls that differ from product to product, and why an llms.txt file is optional rather than required.
Mobile SEO is covered through responsive design, tap targets and font sizes, and international sites through hreflang tags and language declarations. A prioritized checklist — critical, high, medium and ongoing — turns the audit into a work plan with concrete code fixes. Use it with Claude Code to bring a site in line with search best practice.
Key Capabilities
- Evidence-led audit grounded in what the page, headers and code actually show
- robots.txt, XML sitemaps, canonical URLs, URL structure and HTTPS
- Titles, meta descriptions, headings, image SEO and internal links
- Ready-to-adapt JSON-LD, plus AI crawler controls and llms.txt guidance
- Prioritized checklist: critical, high, medium and ongoing
How to use with Claude Code & AI Agents
Install the skill
Run the command above at the root of your project. The CLI asks which agents to set up — Claude Code, Cursor and other supported agents — and adds seo to the project, so teammates who pull the repository get it too. Add-gto install it for your user account across every project.Open a new agent session
Start a fresh Claude Code session in that project so the agent loads the new skill. This skill needs no extra tool or API key.Ask in plain words
Describe the task, for example:“Improve the SEO of this site: fix the meta tags and add structured data.”The agent matches your request to the skill's description and follows its SKILL.md instructions step by step. Read them on GitHub before using the skill on a system that matters.