agentleFS
Maudeunfledged834Maudeunfledged834/startup-founder-skills/skills/seo-technical/SKILL.md

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

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.
  • AgriciDanielSkill

    seo-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

  • timruebenachSkill

    seo-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

  • megastepSkill

    seo-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

  • timruebenachSkill

    seo-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

  • megastepSkill

    seo-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

  • mangollcSkill

    seo-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

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
  1. Distinctive:

    Check robots.txt for unintended disallow rules.

    line 28
  2. Distinctive:

    Verify XML sitemap exists, is submitted to Search Console, and is up to date.

    line 29
  3. Distinctive:

    Check for orphan pages (no internal links pointing to them).

    line 31
  4. Very specific:

    Check site:domain.com results vs.

    line 35
  5. Very specific:

    Look for noindex tags applied unintentionally.

    line 36
  6. Distinctive:

    Check for thin content pages that may be filtered out.

    line 38
  7. Distinctive:

    Verify HTTPS everywhere with proper redirects from HTTP.

    line 41
  8. Distinctive:

    Check for mixed content issues.

    line 42
  9. Distinctive:

    No duplicate content from URL variations (trailing slashes, www vs.

    line 46
  10. Distinctive:

    Test with mobile-friendly tools.

    line 50
  11. Distinctive:

    Check for render-blocking CSS/JS, unoptimized images, excessive third-party scripts.

    line 56
  12. Distinctive:

    Verify server-side rendering or pre-rendering is in place for critical content.

    line 66
  13. Distinctive:

    Test what Googlebot actually sees vs.

    line 67

“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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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.

  1. 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.
  2. Indexation audit — Ensure crawled pages are actually indexed.
    • Check site:domain.com results vs. expected page count.
    • Look for noindex tags 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. 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 plan
  • landing-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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.