agentleFS
figueroaignaciofigueroaignacio/ignaciofigueroa.dev/.agents/skills/seo-geo/SKILL.md

seo-geo

Skill7 starsChanged 2 days agoMITView on GitHub

SEO & GEO (Generative Engine Optimization) for websites. Analyze keywords, generate schema markup, optimize for AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude) and traditional search (Google, Bing). Use when user wants to improve search visibility, search optimization, search ranking, AI visibility, ChatGPT ranking, Google AI Overview, indexing, JSON-LD, meta tags, or keyword research.

58 other projects use a version of this, 9 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use seo-agentic, seo-competitor-pages 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

  • megastepSkill

    seo-competitor-pages

    Generate SEO-optimized competitor comparison and alternatives pages. Covers "X vs Y" layouts, "alternatives to X" pages, feature matrices, schema markup, and conversion optimization. Use when user says "comparison page", "vs page", "alternatives page", "competitor comparison", or "X vs Y".

    Also in 22 projects that use this

  • timruebenachSkill

    seo-google

    Google SEO APIs: Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, and GA4 organic traffic. Provides real Google field data for Core Web Vitals, indexation status, search performance, and organic traffic trends. Use when user says "search console", "GSC", "PageSpeed", "CrUX", "field data", "indexing API", "GA4 organic", "URL inspection", "google api setup", "real CWV data", "impressions", "clicks", "CTR", "position data", "LCP", "INP", "CLS", "FCP", "TTFB", or "Lighthouse scores".

    Also in 14 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 22 projects that use this

  • timruebenachSkill

    seo-image-gen

    AI image generation for SEO assets: OG/social preview images, blog hero images, schema images, product photography, infographics. Powered by Gemini via nanobanana-mcp. Requires banana extension installed. Use when user says \"generate image\", \"OG image\", \"social preview\", \"hero image\", \"blog image\", \"product photo\", \"infographic\", \"seo image\", \"create visual\", \"image-gen\", \"favicon\", \"schema image\", \"pinterest pin\", \"generate visual\", \"banner\", or \"thumbnail\".

    Also in 13 projects that use this

  • +3 more from megastep
  • +4 more from timruebenach

The file

We split this skill into the rules it gives an agent

12 rules. 0 are common, 12 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 53 edited versions we read keep these.

  • 12

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this for: Verify which bots are allowed/blocked.

    line 48
  2. Distinctive:

    Use this for: Verify sitemap structure and ensure all important pages are included for search engine discovery.

    line 58
  3. Distinctive:

    Use WebSearch to research target keywords:

    line 74
  4. Distinctive:

    Search volume and difficulty

    line 84
  5. Distinctive:

    Use "answer-first" format (direct answer at top)

    line 128
  6. Distinctive:

    Update content within 30 days (3.2x more citations)

    line 230
  7. Distinctive:

    Use FAQ Schema (higher citation rate)

    line 237
  8. Distinctive:

    Use structured data (Schema markup)

    line 244
  9. Distinctive:

    Ensure Bing indexing (required for citation)

    line 250
  10. Distinctive:

    Ensure Brave Search indexing (Claude uses Brave, not Google)

    line 257
  11. Distinctive:

    twitter skill: - Search SEO experts for latest tips

    line 265
  12. Distinctive:

    reddit skill: - Search r/SEO, r/bigseo for discussions

    line 266

“Common” is measured: kept by at least 6 in 10 of the 53 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/GEO Optimization Skill

Comprehensive SEO and GEO (Generative Engine Optimization) for websites. Optimize for both traditional search engines (Google, Bing) and AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude).

Quick Reference

GEO = Generative Engine Optimization - Optimizing content to be cited by AI search engines.

Key Insight: AI search engines don't rank pages - they cite sources. Being cited is the new "ranking #1".

Workflow

Step 1: Website Audit

Get the target URL and analyze current SEO/GEO status.

Basic SEO Audit (Free):

python3 scripts/seo_audit.py "https://example.com"

Use this for: Quick technical SEO check (title, meta, H1, robots, sitemap, load time). No API needed.


Check Meta Tags:

curl -sL "https://example.com" | grep -E "<title>|<meta name=\"description\"|<meta property=\"og:|application/ld\+json" | head -20

Use this for: Quick check of essential meta tags and schema markup on any webpage.


Check robots.txt:

curl -s "https://example.com/robots.txt"

Use this for: Verify which bots are allowed/blocked. Critical for ensuring AI search engines can crawl your site.


Check sitemap:

curl -s "https://example.com/sitemap.xml" | head -50

Use this for: Verify sitemap structure and ensure all important pages are included for search engine discovery.

Verify AI Bot Access:

# These bots should be allowed in robots.txt:
- Googlebot (Google)
- Bingbot (Bing/Copilot)
- PerplexityBot (Perplexity)
- ChatGPT-User (ChatGPT with browsing)
- ClaudeBot / anthropic-ai (Claude)
- GPTBot (OpenAI)

Step 2: Keyword Research

Use WebSearch to research target keywords:

WebSearch: "{keyword} keyword difficulty site:ahrefs.com OR site:semrush.com"
WebSearch: "{keyword} search volume 2026"
WebSearch: "site:{competitor.com} {keyword}"

Analyze:

  • Search volume and difficulty
  • Competitor keyword strategies
  • Long-tail keyword opportunities
  • International keyword conflicts (e.g., "OPC" = industrial automation in English markets)

Step 3: GEO Optimization (AI Search Engines)

Apply the 9 Princeton GEO Methods (see references/geo-research.md):

MethodVisibility BoostHow to Apply
Cite Sources+40%Add authoritative citations and references
Statistics Addition+37%Include specific numbers and data points
Quotation Addition+30%Add expert quotes with attribution
Authoritative Tone+25%Use confident, expert language
Easy-to-understand+20%Simplify complex concepts
Technical Terms+18%Include domain-specific terminology
Unique Words+15%Increase vocabulary diversity
Fluency Optimization+15-30%Improve readability and flow
Keyword Stuffing-10%AVOID - hurts visibility

Best Combination: Fluency + Statistics = Maximum boost

Generate FAQPage Schema (+40% AI visibility):

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is [topic]?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "According to [source], [answer with statistics]."
      }
    }
  ]
}

Optimize Content Structure:

  • Use "answer-first" format (direct answer at top)
  • Clear H1 > H2 > H3 hierarchy
  • Bullet points and numbered lists
  • Tables for comparison data
  • Short paragraphs (2-3 sentences max)

Step 4: Traditional SEO Optimization

Meta Tags Template:

<title>{Primary Keyword} - {Brand} | {Secondary Keyword}</title>
<meta name="description" content="{Compelling description with keyword, 150-160 chars}" />
<meta name="keywords" content="{keyword1}, {keyword2}, {keyword3}" />

<!-- Open Graph -->
<meta property="og:title" content="{Title}" />
<meta property="og:description" content="{Description}" />
<meta property="og:image" content="{Image URL 1200x630}" />
<meta property="og:url" content="{Canonical URL}" />
<meta property="og:type" content="website" />

<!-- Twitter Cards -->
<meta name="twitter:card" content="summary_large_image" />
<meta name="twitter:title" content="{Title}" />
<meta name="twitter:description" content="{Description}" />
<meta name="twitter:image" content="{Image URL}" />

JSON-LD Schema (see references/schema-templates.md):

  • WebPage / Article for content pages
  • FAQPage for FAQ sections
  • Product for product pages
  • Organization for about pages
  • SoftwareApplication for tools/apps

Check Content:

  • H1 contains primary keyword
  • Images have descriptive alt text
  • Internal links to related content
  • External links have rel="noopener noreferrer"
  • Content is mobile-friendly
  • Page loads in < 3 seconds

Step 5: Validate & Monitor

Schema Validation:

# Open Google Rich Results Test
open "https://search.google.com/test/rich-results?url={encoded_url}"

# Open Schema.org Validator
open "https://validator.schema.org/?url={encoded_url}"

Check Indexing Status:

# Google (use Search Console API or manual check)
open "https://www.google.com/search?q=site:{domain}"

# Bing
open "https://www.bing.com/search?q=site:{domain}"

Generate Report:

## SEO/GEO Optimization Report

### Current Status

- Meta Tags: ✅/❌
- Schema Markup: ✅/❌
- AI Bot Access: ✅/❌
- Mobile Friendly: ✅/❌
- Page Speed: X seconds

### Recommendations

1. [Priority 1 action]
2. [Priority 2 action]
3. [Priority 3 action]

### GEO Optimizations Applied

- [ ] FAQPage schema added
- [ ] Statistics included
- [ ] Citations added
- [ ] Answer-first structure

Platform-Specific Optimization

See references/platform-algorithms.md for detailed ranking factors.

ChatGPT

  • Focus on branded domain authority (cited 11% more than third-party)
  • Update content within 30 days (3.2x more citations)
  • Build backlinks (>350K referring domains = 8.4 avg citations)
  • Match content style to ChatGPT's response format

Perplexity

  • Allow PerplexityBot in robots.txt
  • Use FAQ Schema (higher citation rate)
  • Host PDF documents (prioritized for citation)
  • Focus on semantic relevance over keywords

Google AI Overview (SGE)

  • Optimize for E-E-A-T (Experience, Expertise, Authority, Trust)
  • Use structured data (Schema markup)
  • Build topical authority (content clusters + internal linking)
  • Include authoritative citations (+132% visibility)

Microsoft Copilot / Bing

  • Ensure Bing indexing (required for citation)
  • Optimize for Microsoft ecosystem (LinkedIn, GitHub mentions help)
  • Page speed < 2 seconds
  • Clear entity definitions

Claude AI

  • Ensure Brave Search indexing (Claude uses Brave, not Google)
  • High factual density (data-rich content preferred)
  • Clear structural clarity (easy to extract)

Skill Dependencies

This skill works best with:

  • twitter skill - Search SEO experts for latest tips
  • reddit skill - Search r/SEO, r/bigseo for discussions
  • WebSearch - Keyword research and competitor analysis

References

  • references/platform-algorithms.md - Detailed ranking factors for each platform
  • references/geo-research.md - Princeton GEO research (9 methods)
  • references/schema-templates.md - JSON-LD templates
  • references/seo-checklist.md - Complete SEO audit checklist
  • references/tools-and-apis.md - Tools and API reference
  • examples/opc-skills-case-study.md - Real-world optimization example

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.