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: Root

📁 .github/
- 📁 actions/
  - 📁 geo-audit/
    
    📄 action.yml 6.1 KB
- 📁 workflows/
  - 📄 ci.yml 1.9 KB
  - 📄 docker.yml 2.4 KB
  - 📄 geo-audit-example.yml 1022 B
  - 📄 publish.yml 1.5 KB
- 📄 dependabot.yml 387 B
📁 ai-context/
- 📄 chatgpt-custom-gpt.md 4.5 KB
- 📄 chatgpt-instructions.md 716 B
- 📄 claude-project.md 11.4 KB
- 📄 cursor.mdc 3.9 KB
- 📄 kiro-steering.md 3.1 KB
- 📄 windsurf.md 4.2 KB
📁 assets/
- 📄 logo.svg 3.2 KB
📁 docs/
- 📄 ai-bots-reference.md 8.6 KB
- 📄 ai-context.md 8.9 KB
- 📄 geo-audit.md 8.5 KB
- 📄 geo-methods.md 9.9 KB
- 📄 getting-started.md 5.0 KB
- 📄 index.md 1.3 KB
- 📄 llms-txt.md 6.2 KB
- 📄 schema-injector.md 12.4 KB
- 📄 scoring-rubric.md 3.2 KB
- 📄 troubleshooting.md 7.3 KB
📁 references/
- 📄 ai-bots-list.md 8.5 KB
- 📄 princeton-geo-methods.md 9.7 KB
- 📄 schema-templates.md 12.6 KB
📁 scripts/
- 📄 generate_llms_txt.py 14.7 KB
- 📄 geo_audit.py 29.9 KB
- 📄 http_utils.py 2.1 KB
- 📄 schema_injector.py 19.4 KB
- 📄 schema_validator.py 6.0 KB
📁 src/
- 📁 geo_optimizer/
  - 📁 cli/
    
    📄 __init__.py 0 B
    
    📄 audit_cmd.py 6.2 KB
    
    📄 formatters.py 7.9 KB
    
    📄 github_formatter.py 2.3 KB
    
    📄 html_formatter.py 5.4 KB
    
    📄 llms_cmd.py 3.6 KB
    
    📄 main.py 998 B
    
    📄 rich_formatter.py 6.1 KB
    
    📄 schema_cmd.py 7.3 KB
    
    📄 scoring_helpers.py 2.1 KB
  - 📁 core/
    
    📄 __init__.py 0 B
    
    📄 audit.py 20.2 KB
    
    📄 llms_generator.py 18.3 KB
    
    📄 registry.py 5.3 KB
    
    📄 schema_injector.py 10.8 KB
    
    📄 schema_validator.py 3.6 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.0 KB
  - 📁 models/
    
    📄 __init__.py 0 B
    
    📄 config.py 8.3 KB
    
    📄 project_config.py 4.1 KB
    
    📄 results.py 5.3 KB
  - 📁 utils/
    
    📄 __init__.py 0 B
    
    📄 cache.py 2.9 KB
    
    📄 http.py 11.2 KB
    
    📄 http_async.py 3.1 KB
    
    📄 robots_parser.py 8.2 KB
    
    📄 validators.py 8.6 KB
  - 📁 web/
    
    📁 templates/
    
    📄 index.html 6.5 KB
    
    📄 __init__.py 244 B
    
    📄 app.py 22.6 KB
    
    📄 badge.py 5.2 KB
    
    📄 cli.py 965 B
  - 📄 __init__.py 1.4 KB
  - 📄 py.typed 0 B
📁 tests/
- 📄 __init__.py 46 B
- 📄 test_audit.py 46.1 KB
- 📄 test_cli.py 43.4 KB
- 📄 test_core.py 79.2 KB
- 📄 test_coverage_m1.py 62.1 KB
- 📄 test_generate_llms_txt.py 43.9 KB
- 📄 test_http_utils.py 2.5 KB
- 📄 test_integration.py 22.5 KB
- 📄 test_p0_security_fixes.py 16.9 KB
- 📄 test_registry.py 9.4 KB
- 📄 test_schema_injector.py 42.7 KB
- 📄 test_schema_validator.py 6.3 KB
- 📄 test_security_critical.py 7.8 KB
- 📄 test_security_m1.py 7.7 KB
- 📄 test_ssrf_hardening.py 16.3 KB
- 📄 test_v21_coverage.py 38.5 KB
- 📄 test_v2_remaining_fixes.py 13.4 KB
- 📄 test_web_app.py 12.8 KB
📄 .dockerignore 227 B
📄 .geo-optimizer.example.yml 848 B
📄 .gitignore 421 B
📄 CHANGELOG.md 25.3 KB
📄 CONTRIBUTING.md 7.6 KB
📄 Dockerfile 2.2 KB
📄 Dockerfile.web 1.7 KB
📄 geo 107 B
📄 install.sh 2.9 KB
📄 LICENSE 1.0 KB
📄 pyproject.toml 3.6 KB
📄 railway.toml 166 B
📄 README.md 16.7 KB
📄 SCORING_RUBRIC.md 4.4 KB
📄 SKILL.md 3.3 KB
📄 update.sh 1.3 KB

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.

No comments yet. Be the first one!

geo-optimizer-skill

Directory Structure

SKILL.md

Report

Notice