geo-optimizer-skill

Category: Databases & Storage | Uploader: Auriti-Labs | Downloads: 0 | Version: v1.0（Latest）

| Platform | File | How to use |

Changelog: Source: GitHub https://github.com/Auriti-Labs/geo-optimizer-skill

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 actions/
  - 📁 geo-audit/
    
    📄 action.yml 7.0 KB
- 📁 ISSUE_TEMPLATE/
  - 📄 bug_report.yml 2.0 KB
  - 📄 config.yml 314 B
  - 📄 feature_request.yml 1.9 KB
  - 📄 new_audit_check.yml 1.6 KB
- 📁 workflows/
  - 📄 ci.yml 2.0 KB
  - 📄 docker.yml 2.4 KB
  - 📄 geo-audit-example.yml 1.9 KB
  - 📄 pages.yml 1.9 KB
  - 📄 publish.yml 1.5 KB
- 📄 dependabot.yml 387 B
- 📄 PULL_REQUEST_TEMPLATE.md 1012 B
📁 ai-context/
- 📄 chatgpt-custom-gpt.md 4.6 KB
- 📄 chatgpt-instructions.md 716 B
- 📄 claude-project.md 11.5 KB
- 📄 cursor.mdc 3.9 KB
- 📄 kiro-steering.md 3.1 KB
- 📄 windsurf.md 4.2 KB
📁 assets/
- 📄 logo.svg 3.2 KB
📁 content/
- 📁 articles/
  - 📄 03-devto-v4-stable-release.md 11.4 KB
  - 📄 03-medium-robots-txt-blocking-chatgpt.txt 11.2 KB
- 📄 published.md 1.0 KB
📁 docs/
- 📄 ai-bots-reference.md 9.4 KB
- 📄 ai-context.md 8.9 KB
- 📄 ci-cd.md 5.1 KB
- 📄 geo-audit.md 11.4 KB
- 📄 geo-fix.md 2.7 KB
- 📄 geo-methods.md 12.7 KB
- 📄 getting-started.md 5.0 KB
- 📄 index.md 1.7 KB
- 📄 llms-txt.md 6.2 KB
- 📄 mcp-server.md 8.3 KB
- 📄 schema-injector.md 12.4 KB
- 📄 scoring-rubric.md 8.3 KB
- 📄 troubleshooting.md 7.4 KB
📁 examples/
- 📄 example_plugin.py 3.2 KB
📁 references/
- 📄 ai-bots-list.md 8.5 KB
- 📄 princeton-geo-methods.md 9.7 KB
- 📄 schema-templates.md 12.6 KB
📁 site/
- 📁 .well-known/
  - 📄 ai.txt 300 B
- 📁 _layouts/
  - 📄 default.html 13.7 KB
- 📁 ai/
  - 📄 faq.json 2.5 KB
  - 📄 service.json 769 B
  - 📄 summary.json 801 B
- 📄 _config.yml 1.3 KB
- 📄 Gemfile 150 B
- 📄 index.md 2.6 KB
- 📄 llms.txt 2.7 KB
- 📄 robots.txt 1.0 KB
📁 src/
- 📁 geo_optimizer/
  - 📁 cli/
    
    📄 __init__.py 35 B
    
    📄 audit_cmd.py 8.5 KB
    
    📄 ci_formatter.py 12.1 KB
    
    📄 fix_cmd.py 4.6 KB
    
    📄 formatters.py 18.2 KB
    
    📄 github_formatter.py 3.6 KB
    
    📄 html_formatter.py 6.7 KB
    
    📄 llms_cmd.py 3.7 KB
    
    📄 main.py 1.1 KB
    
    📄 pdf_formatter.py 909 B
    
    📄 rich_formatter.py 41.9 KB
    
    📄 schema_cmd.py 7.5 KB
    
    📄 scoring_helpers.py 1.9 KB
  - 📁 core/
    
    📄 __init__.py 35 B
    
    📄 audit.py 30.4 KB
    
    📄 audit_ai_discovery.py 6.6 KB
    
    📄 audit_brand.py 9.1 KB
    
    📄 audit_cdn.py 6.0 KB
    
    📄 audit_content.py 2.9 KB
    
    📄 audit_js.py 4.7 KB
    
    📄 audit_llms.py 5.5 KB
    
    📄 audit_meta.py 1.5 KB
    
    📄 audit_negative.py 9.1 KB
    
    📄 audit_robots.py 4.2 KB
    
    📄 audit_schema.py 5.7 KB
    
    📄 audit_signals.py 1.8 KB
    
    📄 audit_webmcp.py 5.9 KB
    
    📄 citability.py 127.9 KB
    
    📄 fixer.py 17.1 KB
    
    📄 injection_detector.py 13.1 KB
    
    📄 llms_generator.py 19.0 KB
    
    📄 registry.py 6.0 KB
    
    📄 schema_injector.py 11.7 KB
    
    📄 schema_validator.py 3.5 KB
    
    📄 scoring.py 6.8 KB
    
    📄 trust_stack.py 15.1 KB
  - 📁 i18n/
    
    📁 locales/
    
    📁 en/
    
    📁 LC_MESSAGES/
    
    📄 geo_optimizer.mo 1.1 KB
    
    📄 geo_optimizer.po 2.3 KB
    
    📁 it/
    
    📁 LC_MESSAGES/
    
    📄 geo_optimizer.mo 1.1 KB
    
    📄 geo_optimizer.po 2.4 KB
    
    📄 __init__.py 2.1 KB
  - 📁 mcp/
    
    📄 __init__.py 121 B
    
    📄 server.py 23.2 KB
  - 📁 models/
    
    📄 __init__.py 35 B
    
    📄 config.py 22.8 KB
    
    📄 project_config.py 4.3 KB
    
    📄 results.py 19.6 KB
  - 📁 utils/
    
    📄 __init__.py 35 B
    
    📄 cache.py 4.0 KB
    
    📄 http.py 11.7 KB
    
    📄 http_async.py 5.9 KB
    
    📄 robots_parser.py 8.2 KB
    
    📄 validators.py 8.3 KB
  - 📁 web/
    
    📁 docs/
    
    📄 ai-bots-reference.md 8.7 KB
    
    📄 ai-context.md 8.9 KB
    
    📄 ci-cd.md 5.1 KB
    
    📄 geo-audit.md 11.4 KB
    
    📄 geo-fix.md 2.7 KB
    
    📄 geo-methods.md 14.6 KB
    
    📄 getting-started.md 5.0 KB
    
    📄 index.md 1.7 KB
    
    📄 llms-txt.md 6.2 KB
    
    📄 mcp-server.md 8.3 KB
    
    📄 schema-injector.md 12.4 KB
    
    📄 scoring-rubric.md 8.3 KB
    
    📄 troubleshooting.md 7.4 KB
    
    📁 templates/
    
    📄 compare.html 15.6 KB
    
    📄 docs.html 10.6 KB
    
    📄 index.html 28.1 KB
    
    📄 manifesto.html 40.5 KB
    
    📄 research.html 14.3 KB
    
    📄 roadmap.html 11.4 KB
    
    📄 __init__.py 272 B
    
    📄 app.py 66.0 KB
    
    📄 badge.py 5.2 KB
    
    📄 cli.py 990 B
  - 📄 __init__.py 1.5 KB
  - 📄 py.typed 0 B
📁 tests/
- 📄 __init__.py 46 B
- 📄 test_ai_discovery.py 29.1 KB
- 📄 test_async.py 4.8 KB
- 📄 test_badge.py 5.7 KB
- 📄 test_brand_entity_signals.py 17.2 KB
- 📄 test_cdn_js_checks.py 10.5 KB
- 📄 test_ci_formatter.py 7.1 KB
- 📄 test_citability.py 76.9 KB
- 📄 test_cli.py 46.3 KB
- 📄 test_core.py 85.2 KB
- 📄 test_coverage_m1.py 61.8 KB
- 📄 test_fix.py 15.9 KB
- 📄 test_http_async.py 14.2 KB
- 📄 test_llms_v2_validation.py 10.5 KB
- 📄 test_mcp.py 14.3 KB
- 📄 test_negative_signals.py 5.9 KB
- 📄 test_p0_security_fixes.py 19.3 KB
- 📄 test_pdf.py 6.0 KB
- 📄 test_prompt_injection.py 19.1 KB
- 📄 test_registry.py 9.4 KB
- 📄 test_ricerca_2025_2026.py 16.9 KB
- 📄 test_schema_richness_394.py 8.6 KB
- 📄 test_security_critical.py 7.7 KB
- 📄 test_security_m1.py 7.8 KB
- 📄 test_ssrf_hardening.py 16.3 KB
- 📄 test_trust_stack.py 14.0 KB
- 📄 test_v21_coverage.py 39.0 KB
- 📄 test_v2_remaining_fixes.py 13.1 KB
- 📄 test_web_app.py 25.3 KB
- 📄 test_webmcp.py 7.5 KB
📄 .dockerignore 227 B
📄 .geo-optimizer.example.yml 865 B
📄 .gitignore 440 B
📄 .mcp.json 148 B
📄 action.yml 4.8 KB
📄 CHANGELOG.md 51.2 KB
📄 CLAUDE.md 7.6 KB
📄 CONTRIBUTING.md 9.2 KB
📄 Dockerfile 2.2 KB
📄 Dockerfile.web 1.9 KB
📄 install.sh 1.3 KB
📄 LICENSE 1.0 KB
📄 pyproject.toml 3.3 KB
📄 README.md 9.8 KB
📄 render.yaml 883 B
📄 SCORING_RUBRIC.md 5.3 KB
📄 SECURITY.md 2.2 KB
📄 SKILL.md 3.3 KB
📄 update.sh 618 B

SKILL.md

# GEO Optimizer — AI Context Files

Choose the file for your platform:

| Platform | File | How to use |
|----------|------|------------|
| Claude Projects | `ai-context/claude-project.md` | Project → Add as Knowledge |
| ChatGPT Custom GPT | `ai-context/chatgpt-custom-gpt.md` | GPT Builder → System prompt (requires paid plan) |
| ChatGPT Custom Instructions | `ai-context/chatgpt-instructions.md` | Settings → Personalization → Custom Instructions |
| Cursor | `ai-context/cursor.mdc` | Copy to `.cursor/rules/geo-optimizer.mdc` |
| Windsurf | `ai-context/windsurf.md` | Copy to `.windsurf/rules/geo-optimizer.md` |
| Kiro | `ai-context/kiro-steering.md` | Copy to `.kiro/steering/geo-optimizer.md` |

## Why different files?

Each platform has different limits and formats:

- **Claude Projects**: no practical limit — full context with workflow, examples, framework code
- **ChatGPT Custom Instructions**: 1,500 character limit per field — ultra-compressed essentials only
- **ChatGPT Custom GPT**: 8,000 character limit (paid plan required) — compressed but complete
- **Cursor**: `.mdc` with YAML frontmatter (`description`, `globs`, `alwaysApply`); glob activates only on matching files
- **Windsurf**: plain `.md`, no YAML frontmatter — activation configured via Windsurf UI (Always On / Glob / Manual)
- **Kiro**: YAML frontmatter with `inclusion: fileMatch` + `fileMatchPattern` array; file goes in `.kiro/steering/`

## Quick copy commands

```bash
# Claude Projects — upload via web UI (claude.ai → Projects → Add content)
# File: ai-context/claude-project.md

# ChatGPT Custom Instructions — paste content via web UI
# File: ai-context/chatgpt-instructions.md (804 chars — fits in one field)

# ChatGPT Custom GPT — paste in GPT Builder → Configure → Instructions
# File: ai-context/chatgpt-custom-gpt.md (~4,500 chars — well within 8,000 limit)

# Cursor
mkdir -p .cursor/rules
cp ~/geo-optimizer-skill/ai-context/cursor.mdc .cursor/rules/geo-optimizer.mdc

# Windsurf
mkdir -p .windsurf/rules
cp ~/geo-optimizer-skill/ai-context/windsurf.md .windsurf/rules/geo-optimizer.md

# Kiro
mkdir -p .kiro/steering
cp ~/geo-optimizer-skill/ai-context/kiro-steering.md .kiro/steering/geo-optimizer.md
```

## File sizes at a glance

| File | Size | Platform limit | Status |
|------|------|---------------|--------|
| `claude-project.md` | ~11,700 chars | No limit | ✅ Full context |
| `chatgpt-custom-gpt.md` | ~4,500 chars | 8,000 chars | ✅ Safe |
| `chatgpt-instructions.md` | ~800 chars | 1,500 chars/field | ✅ Fits in one field |
| `cursor.mdc` | ~4,200 chars | No limit | ✅ Optimized format |
| `windsurf.md` | ~4,500 chars | 12,000 chars (UI activation) | ✅ Optimized format |
| `kiro-steering.md` | ~3,300 chars | No limit | ✅ fileMatch inclusion |

## About GEO Optimizer

GEO Optimizer is a Python toolkit to make websites visible and citable by AI search engines (ChatGPT, Perplexity, Claude, Gemini). It implements the 9 GEO methods from the Princeton KDD 2024 research paper and provides 3 automation scripts:

- `geo_audit.py` — scores your site 0–100, lists what's missing
- `generate_llms_txt.py` — auto-generates `/llms.txt` from your sitemap
- `schema_injector.py` — generates or injects JSON-LD schema into HTML

*GEO Optimizer by Juan Camilo Auriti — https://github.com/auriti-labs/geo-optimizer-skill*

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

geo-optimizer-skill

Directory Structure

SKILL.md

Report

Notice