seo-audit
Skill0 starsChanged 5 months agoMITView on GitHub
SEO audit and optimization for web projects. Trigger on "SEO", "search ranking", "audit my site", "schema markup", "meta tags", "sitemap", "search console", "organic traffic", or when optimizing a site for search engines. Works for any web project.
185 other projects use a version of this.
Adopted by
Most recently taken up by
- vincentventalon/claude-code-video-editing-skilltheir own version, first seen Nov 15, 2026
- vincentventalon/my-claude-skillstheir own version, first seen Nov 15, 2026
- serejaris/personal-corp-ostheir own version, first seen Nov 15, 2026
- vercel/evetheir own version, first seen Nov 15, 2026
- joaoguirunas/team-ostheir own version, first seen Nov 15, 2026
- compozy/compozytheir own version, first seen Nov 13, 2026
Used with
Projects with it also use openseo-review-web-content, openseo-release-notes and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
JwuthriSkillopenseo-review-web-content
Write and review content for the OpenSEO website (web/) — blog posts, guides, feature pages, FAQs. Distills the philosophy for on-brand, useful, accurate content. Use whenever adding or editing user-facing prose in web/content or web/src.
Also in 5 projects that use this
JwuthriSkillopenseo-release-notes
Cut an OpenSEO release — bump the version, draft user-facing release notes from commits since the last tag, run a review + subagent-verification pass, and open a "release: vX.X.X" PR. Use when the user asks to prepare a release, bump the version, or write release notes.
Also in 6 projects that use this
nicepkgSkillcommunity-led-growth
Expert in community-led growth (CLG) - leveraging user communities to drive acquisition, retention, and expansion. Covers building developer communities, user groups, ambassador programs, and turning customers into advocates. Knows the difference between community as a feature vs community as a growth engine, and how to measure community ROI. Use when "community-led, CLG, ambassador program, champion program, user community, developer community, word of mouth, user group, " mentioned.
Also in 5 projects that use this
nicepkgSkillph-community-outreach
Engage Reddit, Indie Hackers, Hacker News and other communities for Product Hunt launches. Use this skill to identify relevant communities, craft appropriate posts, and drive cross-platform engagement without appearing spammy.
Also in 5 projects that use this
xfstudioSkillmicro-saas-launcher
Expert in launching small, focused SaaS products fast - the indie hacker approach to building profitable software. Covers idea validation, MVP development, pricing, launch strategies, and growing to sustainable revenue. Ship in weeks, not months. Use when: micro saas, indie hacker, small saas, side project, saas mvp.
Also in 5 projects that use this
akii-technologies-ltdSkillkeyword-clustering
Cluster and organize keywords into topical groups for SEO. Use when the user asks to "cluster keywords", "group keywords", "organize keywords", "keyword mapping", "topic clusters", "keyword grouping", "build a content plan", "pillar pages", "topical authority", "semantic clustering", or pastes a list of keywords.
Also in 12 projects that use this
- +4 more from nicepkg
- +2 more from Jwuthri
Other versions185 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 185
- coreyhaines31/marketingskills★ 61ksame name
- anthropics/knowledge-work-plugins★ 36ksame name
- AgriciDaniel/claude-seo★ 30ksame name
- every-app/open-seo★ 28ksame name
- trycompai/crm★ 12ksame name
- Ryze-AI-Adgent/open-seo-mcp-skills★ 8.4ksame name
- TheCraigHewitt/seomachine★ 7.5ksame name
- vercel/eve★ 5.9ksame name
- legions-developer/evilcharts★ 3.2ksame name
- MaxMiksa/Auto-Company★ 3.2ksame name
175 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository13 other files it gives its agents.
- AGENTS.mdAGENTS.md
- llms.txtllms.txt
- annotateSkill
- debug-loop-breakerSkill
- deploy-checklistSkill
- goalSkill
- growth-playbookSkill
- security-scannerSkill
- svg-diagramSkill
- tdd-disciplineSkill
- teaching-modeSkill
- verify-frontend-changeSkill
- SKILL_NAMESkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. 0 are common, 12 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 165 edited versions we read keep these.
12
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Before launching a new site or page
- Distinctive: line 15
When organic traffic matters (personal site, product landing pages)
- Distinctive: line 16
When publishing articles (any blog or publication platform)
- Distinctive: line 17
When the user says "SEO", "search ranking", "why isn't my site showing up"
- Distinctive: line 23
Run these checks against the target URL:
- Distinctive: line 68
Check for and recommend JSON-LD structured data:
- Distinctive: line 96
When you don't have paid SEO tools, use these free approaches:
- Distinctive: line 149
Check if AI crawlers can access your site:
- Distinctive: line 163
If robots.txt blocks these, you're invisible to AI search.
- Very specific: line 167
Create a /llms.txt file at your site root — a machine-readable site summary for AI crawlers:
- Distinctive: line 194
If you're one person, focus on these high-ROI link strategies:
- Distinctive: line 262
New sites take 3-6 months to rank: Don't check daily. Set a monthly review cadence.
- Distinctive: line 263
Google Search Console is free and essential: If it's not set up, that's the first fix.
“Common” is measured: kept by at least 6 in 10 of the 165 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
SEO Audit
Adapted from claude-seo by Daniel Agrici (see README Credits).
Full-site SEO analysis with actionable fixes. From meta tags to structured data to content strategy and AI-search (GEO).
When to Use
- Before launching a new site or page
- When organic traffic matters (personal site, product landing pages)
- When publishing articles (any blog or publication platform)
- When the user says "SEO", "search ranking", "why isn't my site showing up"
Phase 1: Technical SEO Audit
1.1 Crawlability Checklist
Run these checks against the target URL:
# Check if robots.txt exists and what it allows
curl -s https://[domain]/robots.txt
# Check sitemap
curl -s https://[domain]/sitemap.xml | head -50
# Check response headers
curl -sI https://[domain]/
# Check page load speed (if lighthouse available)
# npx lighthouse https://[domain] --only-categories=performance,seo --output=json| Check | Status | Fix |
robots.txt exists and doesn't block important pages | ||
sitemap.xml exists and is up-to-date | ||
| All pages return 200 (no 404s, no redirect chains) | ||
| HTTPS everywhere (no mixed content) | ||
| Mobile responsive (viewport meta tag) | ||
| Page load < 3s (LCP) | ||
| No orphan pages (every page linked from at least one other page) |
1.2 On-Page SEO Checklist
For each important page, check:
| Element | Rule | Current | Fix |
<title> | 50-60 chars, keyword near front | ||
<meta description> | 150-160 chars, includes CTA | ||
<h1> | Exactly one per page, contains primary keyword | ||
<h2>-<h6> | Logical hierarchy, no skipped levels | ||
| Images | All have alt text, compressed, proper format (WebP) | ||
| Internal links | Key pages linked from homepage/nav | ||
| URL structure | Short, readable, hyphens not underscores | ||
| Canonical tag | <link rel="canonical"> on every page | ||
| Open Graph | og:title, og:description, og:image set | ||
| Twitter Card | twitter:card, twitter:title, twitter:image set |
1.3 Structured Data (Schema Markup)
Check for and recommend JSON-LD structured data:
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebSite", // or Person, Article, Product, etc.
"name": "...",
"url": "...",
...
}
</script>| Page Type | Recommended Schema | Priority |
| Homepage (personal site) | Person + WebSite | High |
| Blog post / Article | Article + BreadcrumbList | High |
| Product / pricing page | Product + Offer | High |
| Portfolio / Gallery | CreativeWork or ImageGallery | Medium |
| FAQ page | FAQPage | Medium |
Validate at: https://search.google.com/test/rich-results
Phase 2: Content SEO
2.1 Keyword Research (Manual Method)
When you don't have paid SEO tools, use these free approaches:
- Google autocomplete — Type the topic, note suggestions
- "People also ask" — Search the topic, expand all PAA boxes
- Related searches — Bottom of Google results page
- Google Trends — Compare keyword variants (especially across languages/locales)
- Answer the Public (answerthepublic.com) — Question-based keywords
2.2 Content Audit
For existing content, check:
| Page/Post | Primary Keyword | Word Count | Last Updated | Inbound Links | Action |
| ... | ... | ... | ... | ... | Keep/Update/Merge/Delete |
Rules:
- < 300 words → too thin. Expand or merge with another page
- > 12 months since update → refresh or add "Updated YYYY-MM" note
- No inbound links → orphan content. Link from other pages or delete
- Multiple pages targeting same keyword → merge (keyword cannibalization)
2.3 Content Gap Analysis
Compare what you have vs what your audience searches for:
## Keywords We Rank For
(Check Google Search Console → Performance → Queries)
## Keywords We Should Target
1. [keyword] — monthly search volume estimate, difficulty
2. [keyword] — ...
## Content to Create
1. [topic] targeting [keyword] — format: [article/guide/comparison]
2. ...Phase 3: GEO — AI Search Optimization
Google AI Overviews, ChatGPT, Perplexity are now sending traffic. Optimize for them too.
3.1 Citability Score
AI models cite content that is:
- Self-contained passages — 134-167 words per key section (optimal for AI citation)
- Factual and specific — numbers, dates, comparisons (not vague claims)
- Structured — clear headings, lists, tables (easy to extract)
- Authoritative — author bio, credentials, sources cited
3.2 AI Crawler Access
Check if AI crawlers can access your site:
# Check robots.txt for AI bot rules
curl -s https://[domain]/robots.txt | grep -i "GPTBot\|ClaudeBot\|PerplexityBot\|ChatGPT\|Google-Extended"| Crawler | User-Agent | Recommendation |
| Google AI Overview | Google-Extended | Allow (you want AIO citations) |
| ChatGPT | GPTBot | Allow (free traffic) |
| Claude | ClaudeBot | Allow |
| Perplexity | PerplexityBot | Allow |
If robots.txt blocks these, you're invisible to AI search.
3.3 llms.txt
Create a /llms.txt file at your site root — a machine-readable site summary for AI crawlers:
# [Site Name]
> [One-line description]
## Docs
- [Page title](URL): [one-line description]
- [Page title](URL): [one-line description]
## API
- [Endpoint](URL): [description]3.4 Content Optimization for AI Citations
| Element | Traditional SEO | AI SEO (GEO) |
| Headlines | Keyword-first | Question-first ("How to...", "What is...") |
| Content length | 1500-2500 words | 134-167 word self-contained passages within longer content |
| Structure | H2/H3 hierarchy | Definitive statements early in each section |
| Proof | Backlinks | Named sources, specific numbers, comparison tables |
| Freshness | Annual updates | Dated facts, "as of [date]" markers |
Phase 4: Link Building (Solo Builder Edition)
If you're one person, focus on these high-ROI link strategies:
- Personal profiles — GitHub, LinkedIn, dev.to, and other publishing platforms. All link back to your site.
- Guest posts — Write for communities you're already in (company blogs, developer communities)
- Build-in-public content — "How I built X" posts naturally attract links
- Open source — Repos link to your site in README/docs
- Directories — Product Hunt, Indie Hackers, relevant niche directories
Don't waste time on:
- Link exchanges / reciprocal linking
- Buying links
- Spamming forums
- PBNs (private blog networks)
Phase 5: Site-Type Recommendations
Personal site / portfolio
- Schema:
PersonwithsameAslinking to GitHub, LinkedIn - Target keywords: your name, your specialty + location, signature topics you publish about
- Content: guides, project case studies, speaking/presentation links
Product / SaaS landing page
- Schema:
Product+Offerwith pricing - Target keywords: the job-to-be-done, "[category] generator/tool", problem-phrased queries
- Content: how-to guides, sample output, pricing comparison vs the manual alternative
Web app / tool
- Schema:
WebApplication+SoftwareApplication - Target keywords: "[task] online", "[task] tool", the workflow it replaces
- Content: featured use cases, how it works, accuracy/quality comparisons
Output Template
# SEO Audit: [domain]
**Date:** YYYY-MM-DD
**Overall Score:** X/10
## Critical Issues (fix immediately)
1. ...
2. ...
## Warnings (fix soon)
1. ...
2. ...
## Opportunities (growth potential)
1. ...
2. ...
## Technical Checklist: X/Y passed
[Table from Phase 1]
## Content Recommendations
[From Phase 2]
## Next Steps (prioritized)
1. [action] — impact: high/med/low, effort: high/med/low
2. ...Gotchas
- Client-side rendered SPAs need special SEO handling. Pages rendered only in the browser are invisible to crawlers that don't execute JS. Use SSR/SSG (e.g. Next.js) or prerender routes. Check with
curl— if the returned HTML is empty, search engines see nothing. - Multi-locale SEO is a different game. Results on a country-specific Google domain (e.g. google.com.tw) differ from google.com. Test both. Traditional Chinese keywords have different search volumes than Simplified — same lesson applies to any locale split.
- Don't obsess over meta descriptions. Google rewrites them ~70% of the time anyway. Make them good but don't spend hours perfecting them.
- Schema markup doesn't directly improve rankings but it gets you rich snippets (stars, prices, FAQ dropdowns) which improve click-through rate, which DOES improve rankings.
- New sites take 3-6 months to rank. Don't check daily. Set a monthly review cadence.
- Google Search Console is free and essential. If it's not set up, that's the first fix. Everything else is guessing without data.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

