Skills for AI coding agents
A skill is a SKILL.md file that gives an AI agent a workflow, rules and checks for one task. These 30 skills fix the SEO, AEO and GEO problems that stop search engines and AI assistants from reading and citing your site. They work in Claude Code, Cursor and other agents.
- Crawl access
AI crawler robots.txt
Audit robots.txt so the AI and search crawlers you want can reach your site.
- Crawl access
llms.txt
Write an /llms.txt file that follows the llmstxt.org proposal, with a clear link map.
- Crawl access
Cloudflare AI crawler check
Find Cloudflare settings that block AI crawlers and read which bots visit your pages.
- Crawl access
Crawler access test
See what Googlebot, Bingbot, GPTBot and ClaudeBot get for a page, compared to a browser.
- Rendering
Client-side rendering fix
Fix Lovable, Base44, Bolt, Replit and v0 apps that send crawlers an empty HTML shell.
- Rendering
Static HTML twins
Make static HTML copies of SPA pages so crawlers get full content at the same URL.
- Rendering
Soft 404 fix
Find and fix soft 404s, where missing pages return status 200 in single-page apps.
- Rendering
Page speed basics
Check Core Web Vitals and fix the usual causes of slow LCP, slow INP and layout shift.
- On-page
Title tags
Write a unique, accurate title tag for every page, with the main words first.
- On-page
Meta descriptions
Write a unique meta description for each page from facts that are on the page.
- On-page
Canonical tags
Fix rel=canonical tags and duplicate URLs so search engines index one URL per page.
- On-page
Image alt text
Write useful alt text for content images and mark decorative images correctly.
- On-page
hreflang
Set up hreflang for language and country versions, with return links and x-default.
- On-page
Internal linking
Find orphan pages and add descriptive internal links to every important page.
- Schema
Organization schema
Add Organization JSON-LD with logo, url and sameAs so AI tools know your company.
- Schema
SoftwareApplication schema
Add SoftwareApplication JSON-LD with plans and prices for a SaaS or web app.
- Schema
FAQPage schema
Add FAQPage JSON-LD that matches the visible questions and answers on a page.
- Schema
Product schema
Add Product JSON-LD with price, stock and real reviews to ecommerce product pages.
- Schema
Article schema
Add Article or BlogPosting JSON-LD with the headline, dates, author and image.
- Schema
LocalBusiness schema
Add LocalBusiness JSON-LD with address, phone and hours for each location page.
- Content
FAQ blocks for AI answers
Write FAQ blocks that answer real buyer questions so AI assistants can quote them.
- Content
Comparison pages
Plan and write an honest X vs Y comparison page with checked facts and sources.
- Content
Alternatives pages
Write a competitor alternatives page with honest fit notes and checked prices.
- Content
Citation gap content
Find questions where AI assistants cite competitors and plan how to close each gap.
- Content
Entity consistency and sameAs
Make your name, links and facts match across your site, schema and profiles.
- Indexing
XML sitemap
Build an XML sitemap of canonical URLs with accurate lastmod dates and submit it.
- Indexing
IndexNow
Set up IndexNow so Bing learns about your new, changed and deleted URLs at once.
- Indexing
Bing Webmaster Tools setup
Verify your site in Bing Webmaster Tools, submit sitemaps and read the key reports.
- Indexing
Search Console page 2 fixes
Find pages on page 2 of Google with real impressions and plan fixes to move them up.
- Why Won't AI MCP
Why Won't AI scan and fix
Use the Why Won't AI MCP server to scan a site and fix SEO, AEO and GEO issues.
How to install a skill
- Pick a skill and download its SKILL.md file.
- Claude Code: save the file as .claude/skills/<skill-name>/SKILL.md in your project. For all projects, use ~/.claude/skills.
- Cursor and other agents: add the file to your project and tell the agent to follow it, or paste it into the agent's rules.
- Ask the agent to do the task, for example "fix the title tags on my site".
Install from the terminal
mkdir -p .claude/skills/title-tags && curl -fsSL https://whywontai.com/skills/title-tags.md -o .claude/skills/title-tags/SKILL.mdmkdir -p ~/.claude/skills/title-tags && curl -fsSL https://whywontai.com/skills/title-tags.md -o ~/.claude/skills/title-tags/SKILL.mdChange title-tags to the name of the skill you want.
Questions
What is a skill file?
A skill is a folder with a SKILL.md file. The file has a name, a description and instructions. An agent reads the description and loads the full instructions when a task matches.
How do I install a skill in Claude Code?
Make a folder with the skill name in .claude/skills in your project, or in ~/.claude/skills for all your projects. Save the file in that folder as SKILL.md. If Claude Code does not show the skill, start a new session.
Can I use these skills in Cursor or other agents?
Yes. Each skill is a plain Markdown file. Add the file to your project and tell the agent to follow it, or paste the text into the agent's rules or instructions.
Are the skills free?
Yes. You can download, copy and change them. You do not need an account.
Where does the guidance in the skills come from?
The skills use public documentation from Google Search Central, Bing Webmaster Tools, Schema.org, llmstxt.org, web.dev and the crawler owners. Each file lists its sources. These rules change, so check the source before you rely on a rule.
Do I need Why Won't AI to use the skills?
No. One skill uses the Why Won't AI MCP server to scan a site and list issues. The other skills work without it.
Find the issues first
The free scan shows what each search and AI crawler gets from your site. Then use the skill that fixes each issue.