seo-geo-optimizer
Skill43 starsChanged 6 months agoMITView on GitHub
Audit and optimize content for SEO, GEO (generative engine optimization), and AEO (answer engine optimization). Use when user asks to "audit SEO", "check search visibility", "optimize for AI search", "generate schema markup", "validate metadata", "extract keywords", "optimize for Perplexity/ChatGPT/Gemini", "check Open Graph tags", "submit to IndexNow", or mentions SEO, GEO, AEO, or search optimization. Do NOT use for creating new content from scratch or image optimization.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- Aryanpanwar10005/seo-geo-optimizertheir own version, first seen Nov 1, 2026
- torisKR/toris-agenttheir own version, first seen Jul 28, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- Aryanpanwar10005/seo-geo-optimizer★ 14same name
- torisKR/toris-agent★ 2same name
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.
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
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 41
Before running any script, verify:
- Distinctive: line 47
FileNotFoundError: Check the path. Scripts accept absolute or relative paths.
- Very specific: line 49
Low scores (< 50): Not an error. Run audit_report.py --format all for detailed recommendations, then apply fixes with auto_implementer.py.
- Very specific: line 50
Script import errors: All scripts share scripts/shared/ utilities.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
SEO/GEO/AEO Optimizer
Audit content for search engine and AI platform visibility. Generates schema markup, validates metadata, extracts keywords, and produces actionable reports.
When NOT to Use
- Creating new content from scratch (use content generation tools)
- Image optimization (use image-specific tools)
- Server-side performance (use web performance tools)
Decision Matrix
Pick the right script based on user intent:
| User Wants | Script | Input |
| Full audit with report | scripts/audit_report.py <file> --format all | HTML/MD/JSX |
| Content structure analysis | scripts/analyze_content.py <file> | HTML/MD/JSX |
| Meta tag validation | scripts/metadata_validator.py <file> | HTML |
| Keyword extraction | scripts/keyword_analyzer.py <file> | Any text |
| Entity extraction | scripts/entity_extractor.py <file> | Any text |
| Schema markup generation | scripts/schema_generator.py <type> [args] | CLI args |
| AI platform optimization | scripts/auto_implementer.py <file> <platform> | HTML + platform |
| Content optimization | scripts/content_optimizer.py <file> | HTML/MD |
| Citation enhancement | scripts/citation_enhancer.py <file> | HTML/MD |
| Voice search optimization | scripts/voice_optimizer.py <file> | HTML/MD |
| Freshness monitoring | scripts/freshness_monitor.py <file> | HTML |
| IndexNow submission | scripts/indexnow_submit.py <url> | URL |
Platforms for auto_implementer: chatgpt, perplexity, claude, gemini, grokipedia
Schema types: faq, article, howto, organization, person
Preflight
Before running any script, verify:
- File exists and is a supported type (.html, .md, .mdx, .jsx, .tsx)
- Python 3.7+ available (scripts use stdlib only, no external deps)
Error Handling
- FileNotFoundError: Check the path. Scripts accept absolute or relative paths.
- JSON decode errors: The input file may have malformed schema markup. Run
metadata_validator.pyfirst to identify issues. - Low scores (< 50): Not an error. Run
audit_report.py --format allfor detailed recommendations, then apply fixes withauto_implementer.py. - Script import errors: All scripts share
scripts/shared/utilities. Ensure the full scripts directory is intact.
Output
Reports saved to ~/Documents/SEO_Audit_YYYY-MM-DD_HH-MM-SS/ in three formats:
- JSON: Raw audit data for programmatic use
- Markdown: Readable report with recommendations
- HTML: Visual dashboard with scores and charts
References
| File | When to Read |
reference/scripts-reference.md | Detailed script flags and options |
reference/troubleshooting.md | Common issues and solutions |
reference/platform-strategies.md | Platform-specific optimization strategies |
reference/citation-optimization-guide.md | AI citation and GEO strategies |
reference/schema-library.md | Complete JSON-LD schema reference |
reference/entity-seo-guide.md | Knowledge Graph optimization |
reference/voice-search-guide.md | Voice search and AEO optimization |
reference/social-preview-guide.md | Open Graph and Twitter Card setup |
reference/statistics-2026.md | May 2026 review — what shifted, what survived, what to drop |
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.

