seo-technical
Skill8 starsChanged 8 months agoMITView on GitHub
When the user needs a technical SEO audit, on-page optimization guidance, or help resolving crawlability, indexation, or performance issues that affect search rankings.
38 other projects use a version of this.
Adopted by
Most recently taken up by
- alpit-patel/seo-aeo-geo-kittheir own version, first seen Nov 8, 2026
- brainbytes-dev/everything-claude-marketingtheir own version, first seen Nov 1, 2026
- zhtyyx/codex-seotheir own version, first seen Nov 1, 2026
- joaoguirunas/team-ostheir own version, first seen Oct 21, 2026
- DoddleHQ/doddle-seo-geo-skillstheir own version, first seen Oct 20, 2026
- susantedit/claude-skillstheir own version, first seen Oct 20, 2026
Used with
Projects with it also use seo-agentic, seo-maps 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.
AgriciDanielSkillseo-agentic
Audit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Use when the user asks whether AI agents can use or browse the site, or about llms.txt or WebMCP. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).
Also in 5 projects that use this
timruebenachSkillseo-maps
Maps intelligence for local SEO — geo-grid rank tracking, GBP profile auditing via API, review intelligence across Google/Tripadvisor/Trustpilot, cross-platform NAP verification (Google/Bing/Apple/OSM), competitor radius mapping, and LocalBusiness schema generation from API data. Three-tier capability: free (Overpass + Geoapify), DataForSEO (full intelligence), DataForSEO + Google (maximum coverage). Use when user says "maps", "geo-grid", "rank tracking", "GBP audit", "review velocity", "competitor radius", "maps analysis", "local rank tracking", "Share of Local Voice", or "SoLV".
Also in 17 projects that use this
megastepSkillseo-sitemap
Analyze existing XML sitemaps or generate new ones with industry templates. Validates format, URLs, and structure. Use when user says "sitemap", "generate sitemap", "sitemap issues", or "XML sitemap".
Also in 29 projects that use this
timruebenachSkillseo-ecommerce
E-commerce SEO analysis: Google Shopping visibility, Amazon marketplace intelligence, product schema validation, competitor pricing analysis, and marketplace keyword gaps. Combines on-page product SEO with marketplace data from DataForSEO Merchant API. Use when user says "ecommerce SEO", "product SEO", "Google Shopping", "marketplace SEO", "product schema", "Amazon SEO", "product listings", "shopping ads", or "merchant SEO".
Also in 17 projects that use this
megastepSkillseo-images
Image optimization analysis for SEO and performance. Checks alt text, file sizes, formats, responsive images, lazy loading, and CLS prevention. Use when user says "image optimization", "alt text", "image SEO", "image size", or "image audit".
Also in 25 projects that use this
mangollcSkillseo-backlinks
Backlink analysis and link building strategy: competitor backlink profiling, outreach plan generation, monthly SEO reporting framework, toxic link identification, link opportunity scoring, and unlinked mention discovery.
Also in 18 projects that use this
- +3 more from timruebenach
- +3 more from megastep
Other versions38 projects use a version of this.
Word for word · 1
- shawnpang/startup-founder-skills★ 331100% same
Edited · 0
None found.
Wrote their own version · 37
- AgriciDaniel/claude-seo★ 20ksame name
- zhtyyx/codex-seo★ 152same name
- ronaldships/foundvia-discovery★ 29same name
- Thibaultbm/claude-seo-geo★ 18same name
- coopersimson96/ai-content-system★ 17same name
- ZachArticulateV/designer-pro-and-seo★ 10same name
- brainbytes-dev/everything-claude-marketing★ 9same name
- YepAPI/skills★ 8same name
- joaoguirunas/team-os★ 6same name
- oegeyilmaz9/seo-aeo-geo-ultimate★ 6same name
27 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 repository49 other files it gives its agents.
- accelerator-applicationSkill
- architecture-designSkill
- board-updateSkill
- churn-analysisSkill
- cicd-setupSkill
- code-reviewSkill
- cold-outreachSkill
- community-discoverySkill
- competitive-analysisSkill
- competitor-monitoringSkill
- content-strategySkill
- contract-reviewSkill
- daily-product-digestSkill
- data-roomSkill
- earned-media-outreachSkill
- email-marketingSkill
- employer-brandSkill
- event-hostingSkill
- feedback-synthesisSkill
- founder-thought-leadershipSkill
- fundraising-emailSkill
- interview-kitSkill
- investor-researchSkill
- job-descriptionSkill
- landing-pageSkill
- launch-strategySkill
- lead-scoringSkill
- market-researchSkill
- mvp-scopingSkill
- onboarding-flowSkill
- partnership-outreachSkill
- pitch-deckSkill
- prd-writingSkill
- privacy-policySkill
- process-docsSkill
- proposal-generationSkill
- review-miningSkill
- roadmap-planningSkill
- sales-scriptSkill
- security-reviewSkill
- sentiment-monitoringSkill
- soc2-prepSkill
- social-contentSkill
- sourcing-outreachSkill
- startup-contextSkill
- support-docsSkill
- tech-stack-evalSkill
- terms-of-serviceSkill
- user-research-synthesisSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. 0 are common, 11 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 34 edited versions we read keep these.
11
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 28
Check robots.txt for unintended disallow rules.
- Distinctive: line 29
Verify XML sitemap exists, is submitted to Search Console, and is up to date.
- Distinctive: line 31
Check for orphan pages (no internal links pointing to them).
- Very specific: line 35
Check site:domain.com results vs.
- Very specific: line 36
Look for noindex tags applied unintentionally.
- Distinctive: line 38
Check for thin content pages that may be filtered out.
- Distinctive: line 41
Verify HTTPS everywhere with proper redirects from HTTP.
- Distinctive: line 42
Check for mixed content issues.
- Distinctive: line 46
No duplicate content from URL variations (trailing slashes, www vs.
- Distinctive: line 50
Test with mobile-friendly tools.
- Distinctive: line 56
Check for render-blocking CSS/JS, unoptimized images, excessive third-party scripts.
- Distinctive: line 66
Verify server-side rendering or pre-rendering is in place for critical content.
- Distinctive: line 67
Test what Googlebot actually sees vs.
“Common” is measured: kept by at least 6 in 10 of the 34 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 Technical
When to Use
- Running a technical SEO audit on an existing site.
- Diagnosing why pages are not being indexed or ranked.
- Optimizing Core Web Vitals or page speed.
- Setting up site architecture (sitemaps, robots.txt, canonicalization).
- Implementing structured data / schema markup.
- Managing AI crawler access via robots.txt.
- Preparing a new site or migration for SEO readiness.
- Reviewing JavaScript rendering and its impact on indexation.
Context Required
- From startup-context: product description, target audience, primary keywords, current domain and site structure.
- From the user: site URL, access to Google Search Console data (if available), specific pages of concern, known issues, tech stack (static site, SPA, WordPress, etc.), whether the site has been previously audited.
Workflow
Audit across 9 technical dimensions. Score on a 100-point scale with category breakdowns.
- Crawlability audit — Foundation; nothing else matters if search engines cannot crawl the site.
- Check robots.txt for unintended disallow rules.
- Verify XML sitemap exists, is submitted to Search Console, and is up to date.
- Identify crawl errors (4xx, 5xx status codes).
- Check for orphan pages (no internal links pointing to them).
- Audit redirect chains — flatten to single hops. Chains of 3+ waste crawl budget and dilute link equity.
- For sites with 10,000+ pages, analyze crawl budget efficiency and remove low-value pages from the index.
- Indexation audit — Ensure crawled pages are actually indexed.
- Check
site:domain.comresults vs. expected page count. - Look for
noindextags applied unintentionally. - Identify duplicate content issues and missing canonical tags.
- Check for thin content pages that may be filtered out.
- Review index coverage report in Search Console for excluded pages.
- Check
- Security and HTTPS — HTTPS is a ranking signal and a trust requirement.
- Verify HTTPS everywhere with proper redirects from HTTP.
- Check for mixed content issues.
- Validate SSL certificate and HSTS headers.
- URL structure — Short, descriptive, hyphenated URLs without parameters.
- Consistent URL patterns across the site.
- No duplicate content from URL variations (trailing slashes, www vs. non-www).
- Self-referencing canonical tags on every page.
- Mobile optimization — As of July 2024, Google crawls and indexes ALL websites exclusively with the mobile Googlebot user-agent. Mobile-first is not optional.
- Mobile and desktop content parity is mandatory.
- Test with mobile-friendly tools.
- Responsive design, no horizontal scroll, touch targets properly sized.
- Core Web Vitals — Google uses these as ranking signals. Current targets:
- LCP (Largest Contentful Paint): Target under 2.5 seconds. Fixes: optimize hero images, implement lazy loading, use CDN, reduce server response time.
- INP (Interaction to Next Paint): Target under 200ms. INP replaced FID in March 2024. Fixes: reduce JavaScript execution time, break up long tasks, optimize event handlers.
- CLS (Cumulative Layout Shift): Target under 0.1. Fixes: set explicit dimensions on images/embeds, avoid injecting content above existing content, use
font-display: swap. - Check for render-blocking CSS/JS, unoptimized images, excessive third-party scripts.
- Structured data — Implement schema markup for rich results.
- Organization schema on the homepage.
- Article/BlogPosting schema on content pages.
- Product schema on product pages.
- FAQ schema where applicable (boosts SERP real estate).
- BreadcrumbList schema for navigation clarity.
- Validate with Google's Rich Results Test.
- JavaScript rendering — Critical for SPAs and JS-heavy sites.
- Serve canonical tags, robots directives, and structured data in initial server-rendered HTML. Google may not reliably process these if injected via JavaScript.
- Verify server-side rendering or pre-rendering is in place for critical content.
- Test what Googlebot actually sees vs. what users see.
- AI crawler management — Managing AI crawlers via robots.txt is a critical 2025-2026 consideration.
- GPTBot (OpenAI), ClaudeBot (Anthropic), PerplexityBot, Bytespider (ByteDance), Google-Extended
- Blocking Google-Extended does NOT affect Google Search indexing or AI Overviews — only Gemini training data.
- Decide per-crawler based on business needs: allow, block, or rate-limit.
Output Format
A prioritized audit report scored on a 100-point scale:
- Critical issues (blocking indexation or causing major ranking loss): fix immediately
- High-impact improvements (will meaningfully improve rankings): fix within 2 weeks
- Medium improvements (incremental gains): fix within 30 days
- Low priority (minor optimizations): address when convenient
Each item includes: the issue, why it matters for rankings, how to fix it, and estimated effort (low/medium/high).
Frameworks & Best Practices
- Canonical tags are directives, not suggestions: While Google treats them as hints, properly implemented canonicals are followed in the vast majority of cases. Always self-canonical pages and canonical duplicates to the preferred version.
- JavaScript SEO: Critical metadata (canonical, robots, structured data) must be in initial server-rendered HTML. Google can render JS but with delays and reliability gaps.
- Mobile-first is complete: Since July 2024, there is no "desktop index." The mobile version IS the version Google indexes. Full content parity is non-negotiable.
- INP replaced FID: FID was fully removed from Chrome tools by September 2024. All performance optimization should target INP (under 200ms), not FID.
- Crawl budget: Rarely an issue for sites under 10,000 pages. For larger sites, prioritize by removing low-value pages and fixing redirect chains.
- Hreflang for international sites: Implement correctly or not at all. Errors cause worse indexation than no hreflang tags.
- Log file analysis: Server logs reveal what Googlebot actually crawls vs. what you want crawled. This is the ground truth of crawlability.
- Speed is a tiebreaker: Rarely causes dramatic ranking changes alone, but affects user behavior metrics (bounce rate, time on site) which indirectly impact rankings.
- E-E-A-T signals matter: Author bios with credentials, about page, contact info, links to authoritative sources, HTTPS, privacy policy, terms of service.
Related Skills
content-strategy— when the audit reveals content gaps or thin content that needs a broader content planlanding-page— when key landing pages need both CRO and on-page SEO optimization
Examples
Example 1: Full audit
"We launched our site 6 months ago and we're barely showing up in Google. Can you audit our SEO?"
Good output: A structured audit across all 9 dimensions with a 100-point score. Identifies that robots.txt is blocking the /blog/ directory, sitemap is missing, several pages have duplicate title tags, Core Web Vitals are failing on mobile (LCP at 4.2s due to unoptimized hero image), canonical tags and structured data are injected via JavaScript instead of server-rendered HTML, and no AI crawler policy is defined. Prioritized fix list with critical, high, medium, and low items with effort estimates.
Example 2: Specific issue
"Our blog posts were ranking well but traffic dropped 40% last month."
Good output: Diagnostic checklist starting with Search Console data review (manual actions, crawl errors, index coverage changes), then checking for algorithm update timing, content cannibalization between similar posts, accidental noindex or broken canonicals, Core Web Vitals regression (especially INP after a JS-heavy deploy), lost backlinks, and mobile rendering issues. Recommends specific data to gather and steps to isolate the cause.
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.

