# Send GEO Optimization to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "geo-optimization",
    "name": "GEO Optimization",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/capt-marbles/geo-optimization",
    "canonicalUrl": "https://clawhub.ai/capt-marbles/geo-optimization",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/geo-optimization",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=geo-optimization",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/audit-template.md",
      "scripts/geo-daily-monitor.sh",
      "scripts/geo-daily-report.py",
      "scripts/geo-monitor.py",
      "scripts/geo-test-queries.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "geo-optimization",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T11:44:16.034Z",
      "expiresAt": "2026-05-10T11:44:16.034Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=geo-optimization",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=geo-optimization",
        "contentDisposition": "attachment; filename=\"geo-optimization-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "geo-optimization"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/geo-optimization"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/geo-optimization",
    "downloadUrl": "https://openagent3.xyz/downloads/geo-optimization",
    "agentUrl": "https://openagent3.xyz/skills/geo-optimization/agent",
    "manifestUrl": "https://openagent3.xyz/skills/geo-optimization/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/geo-optimization/agent.md"
  }
}
```
## Documentation

### GEO: Generative Engine Optimization

Optimize content to appear in AI-powered search engines (ChatGPT, Perplexity, Claude, Google AI Overviews). GEO is about being parseable, quotable, and authoritative — not keyword stuffing.

### Quick Reference

GoalTacticGet cited in AI answersAdd specific statistics, quotable factsAppear in comparisonsCreate definitive comparison tablesAnswer user questionsComprehensive FAQ sectionsEstablish entityClear first-paragraph definitionsBuild authorityThird-party mentions, backlinks, freshness signals

### GEO vs SEO: Key Differences

AspectTraditional SEOGEOGoalRank on SERPsGet cited in AI responsesKeywordsExact match mattersSemantic understandingContent styleCan be promotionalMust be factual, neutralStructureHeaders for scanningHeaders + parseable dataLinksBacklinks for authorityCitations + entity mentionsFreshnessHelpfulCritical (LLMs prefer recent)FormatLong-form winsQuotable chunks win

### The GEO Audit Checklist

Score each page 0-2 points per item (0=missing, 1=partial, 2=excellent):

### 1. Entity Clarity (Max 10 pts)

First paragraph clearly defines what/who the entity is
 Entity name used consistently throughout
 Clear category placement ("X is a [type of thing]")
 Relationship to other known entities stated
 Wikipedia-style objectivity in tone

### 2. Quotable Facts (Max 10 pts)

Specific numbers present (not "many" or "fast")
 Statistics are current and sourced
 Claims are concrete and verifiable
 Key facts in standalone sentences (easy to extract)
 "By the numbers" or facts section exists

### 3. FAQ Coverage (Max 10 pts)

FAQ section exists
 Questions match how users prompt LLMs
 Answers are direct and complete
 FAQ schema markup implemented
 Covers "what is", "how does", "why", "vs" questions

### 4. Comparison Positioning (Max 10 pts)

Comparison tables exist
 Competitors named explicitly
 Factual differences highlighted (not just marketing)
 "Alternative to X" content exists
 Fair representation (not obviously biased)

### 5. Structural Clarity (Max 10 pts)

Clear heading hierarchy (H1→H2→H3)
 Bullet points for lists
 Tables for comparisons
 Short paragraphs (2-4 sentences)
 Summary/TL;DR at top or bottom

### 6. Authority Signals (Max 10 pts)

Author/company credentials stated
 Customer names/logos (social proof)
 Case studies with real numbers
 Third-party mentions/citations
 "Last updated" date present

### 7. Freshness (Max 10 pts)

Page has recent update date
 Content reflects current year
 No outdated references
 Regular content updates
 News/changelog section exists

Scoring:

60-70: Excellent GEO readiness
45-59: Good, needs some optimization
30-44: Fair, significant gaps
<30: Poor, major overhaul needed

### Template 1: Entity Definition Page

# [Entity Name]

**[Entity Name]** is a [category] that [primary function]. 
Unlike [alternative/competitor], [Entity Name] offers [key differentiator].

## [Entity Name] by the Numbers

- [Specific stat 1]
- [Specific stat 2]
- [Specific stat 3]
- [Specific stat 4]

## How [Entity Name] Works

[2-3 paragraphs explaining core functionality]

## Who Uses [Entity Name]

[Named customers with context]

## Frequently Asked Questions

### What is [Entity Name]?
[Direct answer in 2-3 sentences]

### How is [Entity Name] different from [Competitor]?
[Factual comparison]

### How much does [Entity Name] cost?
[Pricing info or guidance]

*Last updated: [Date]*

### Template 2: Comparison Page (Alternative To)

# Best [Competitor] Alternative: [Your Product] (2026)

> **Summary:** [Your Product] is a [category] offering [key differentiators]. 
> [Customers] report [specific result] compared to [Competitor].

*Last updated: [Date]*

## Why [Users] Look for [Competitor] Alternatives

### Problem 1: [Specific Pain Point]
[Explanation with specifics]

### Problem 2: [Specific Pain Point]
[Explanation with specifics]

## [Your Product] vs [Competitor]: Comparison

| Feature | [Competitor] | [Your Product] |
|---------|--------------|----------------|
| [Feature 1] | [Their approach] | [Your approach] |
| [Feature 2] | [Their approach] | [Your approach] |
| [Feature 3] | [Their approach] | [Your approach] |

## Key Differences

### [Differentiator 1]
[Factual explanation with numbers]

### [Differentiator 2]
[Factual explanation with numbers]

## Customer Results

> "[Quote with specific result]"
> — [Name], [Title], [Company]

## Frequently Asked Questions

### Is [Your Product] a good alternative to [Competitor]?
[Direct answer]

### How does [Your Product] compare to [Competitor] on [key factor]?
[Specific comparison]

### Can I migrate from [Competitor] to [Your Product]?
[Migration info]

## Summary

[Your Product] is a [category] offering [key benefits]. [Customers] 
using [Your Product] instead of [Competitor] report [specific results].

*[Your Product] has [credibility stat]. Learn more at [link].*

### Template 3: FAQ Page (LLM Optimized)

# [Topic] FAQ

Answers to common questions about [topic].

*Last updated: [Date]*

## General Questions

### What is [thing]?
[Thing] is a [category] that [function]. It is used by [who] to [accomplish what].

### How does [thing] work?
[Thing] works by [process]. [Additional detail].

### Who uses [thing]?
[Thing] is used by [user types], including [specific examples like Company A, Company B].

## Comparison Questions

### How is [thing] different from [alternative]?
[Thing] differs from [alternative] in [specific ways]:
- [Difference 1]
- [Difference 2]
- [Difference 3]

### Is [thing] better than [alternative]?
[Thing] is better suited for [use cases] because [reasons]. 
[Alternative] may be better for [other use cases].

## Pricing & Access

### How much does [thing] cost?
[Pricing information or range]

### Is there a free trial?
[Trial information]

## Technical Questions

### What are the requirements for [thing]?
[Requirements list]

### How do I get started with [thing]?
1. [Step 1]
2. [Step 2]
3. [Step 3]

### Perplexity AI

How it works: 3-layer reranking system

Initial retrieval from web index
Relevance scoring
Citation selection based on authority + recency

Optimization tactics:

Strong domain authority matters
Freshness signals critical (update dates)
Direct answers to questions
Being cited by other authoritative sources
Structured data helps parsing

### ChatGPT / SearchGPT

How it works: Bing-powered search + LLM synthesis

Optimization tactics:

Bing indexing matters (submit sitemap to Bing)
E-E-A-T signals weighted heavily
Conversational content structure
FAQ format highly effective
Named entities help recognition

### Google AI Overviews

How it works: Google's index + Gemini synthesis

Optimization tactics:

Traditional SEO still matters (ranking helps)
Featured snippet optimization
Schema markup (FAQ, HowTo, Product)
Clear, authoritative content
Mobile-first indexing

### Claude

How it works: Training data + retrieval (when web-enabled)

Optimization tactics:

Quality content in training sources
Wikipedia mentions help entity recognition
Technical accuracy valued
Clear, well-structured prose
Being cited in authoritative sources

### Schema Markup for GEO

Organization Schema:

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Company Name",
  "description": "Clear description of what company does",
  "url": "https://example.com",
  "foundingDate": "2017",
  "numberOfEmployees": "50-100",
  "sameAs": [
    "https://twitter.com/company",
    "https://linkedin.com/company/company"
  ]
}

FAQ Schema:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [{
    "@type": "Question",
    "name": "What is [thing]?",
    "acceptedAnswer": {
      "@type": "Answer",
      "text": "Direct answer here."
    }
  }]
}

Product Schema:

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Product Name",
  "description": "Product description",
  "brand": {"@type": "Brand", "name": "Brand"},
  "offers": {
    "@type": "Offer",
    "priceCurrency": "USD",
    "price": "99"
  }
}

### llms.txt Protocol

Create /llms.txt at your site root to help LLMs understand your site:

# Site Name

> Brief description of what this site/company is.

## Main Sections

- [Products](/products): Description of products section
- [Documentation](/docs): Technical documentation
- [Blog](/blog): Industry insights and updates

## Key Facts

- Founded: 2017
- Customers: 500+ companies
- Key metric: [specific number]

## Contact

- Website: https://example.com
- Email: hello@example.com

### Manual Testing

Regularly search these prompts on each platform:

Perplexity:

"What is [your company]?"
"Best [competitor] alternative"
"[Your category] comparison"
"How does [your product] work?"

ChatGPT:

Same queries with web browsing enabled
"Compare [your product] vs [competitor]"

Google (AI Overview):

"[Your category] solutions"
"[Competitor] alternative"

### Tracking Tools

ToolWhat It TracksPriceOtterly.AIMulti-platform AI visibilityFree tierAhrefs Brand RadarAI search mentions$129+/moProfoundEnterprise benchmarkingEnterpriseManual trackingDIY spreadsheetFree

### Key Metrics

Mention rate: % of relevant queries where you appear
Citation rate: % of mentions that cite/link to you
Sentiment: Positive/neutral/negative portrayal
Share of voice: Your mentions vs competitors
Position: Where in the response you appear

### DO:

✅ Use specific numbers ("0.5 seconds" not "fast")
✅ Make claims quotable and standalone
✅ Structure content with clear hierarchy
✅ Include FAQ sections
✅ Update content regularly with dates
✅ Create comparison content
✅ Use tables for data
✅ Be factual and neutral in tone
✅ Name real customers and results

### DON'T:

❌ Use vague superlatives ("best", "leading", "top")
❌ Keyword stuff (LLMs see through it)
❌ Write walls of text without structure
❌ Hide information (be comprehensive)
❌ Use outdated statistics
❌ Ignore competitors (address them directly)
❌ Be obviously promotional (neutral wins)

### Quick Start Checklist

For any page you want to optimize for GEO:

Add clear entity definition in first paragraph
 Include 5+ specific, quotable statistics
 Add FAQ section with 5+ questions
 Create comparison table (if relevant)
 Add "last updated" date
 Implement FAQ schema markup
 Ensure H1→H2→H3 hierarchy
 Test on Perplexity: does your content appear?

### Automated GEO Monitoring

Track your citation rate over time with the included monitoring scripts!

### Quick Start

Test current visibility:

python3 scripts/geo-monitor.py --test

Single query test:

python3 scripts/geo-monitor.py --query "best game server orchestration platform"

Generate daily report:

python3 scripts/geo-daily-report.py

### Setup Automated Monitoring

1. Create your test queries file (scripts/geo-test-queries.json):

{
  "queries": [
    {
      "query": "your target query here",
      "category": "brand|product|comparison|problem|competitor"
    }
  ]
}

2. Run daily monitoring:

# Add to cron for daily 9am checks
0 9 * * * cd /path/to/skill && bash scripts/geo-daily-monitor.sh

### Understanding the Reports

Citation Rate: Percentage of queries where you appear in AI responses

0-20%: Early stage, needs work
20-40%: Building visibility
40-60%: Strong presence
60%+: Dominant authority

Categories tracked:

Brand queries (you should own these!)
Product/feature queries
Comparison queries (vs competitors)
Problem/pain point queries
Competitor comparison queries

### Monitoring Best Practices

Start with 15-20 strategic queries across all categories
Test daily during optimization period (first 2 weeks)
Weekly checks once you hit target citation rate
Track changes after content updates (expect 3-7 day lag)
Focus on gaps - queries with 0% citation are your opportunities

### What to Track

Current state:

Total citation rate
Citations by category
Position when cited (#1, #2, etc.)
Critical gaps (0% coverage)

Over time:

Citation rate trend (weekly/monthly)
New citations gained
Lost citations (content freshness!)
Category improvements

### Files Included

scripts/geo-monitor.py - Main testing script (uses Perplexity API)
scripts/geo-daily-report.py - Formatted report generator
scripts/geo-daily-monitor.sh - Cron-friendly wrapper
scripts/geo-test-queries.json - Example query file

Requirements: Perplexity API key (configure via web_search in Clawdbot)

### Resources

Awesome GEO GitHub
Princeton GEO Research Paper
Google AI Search Guidance
Perplexity Ranking Factors
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: capt-marbles
- Version: 1.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T11:44:16.034Z
- Expires at: 2026-05-10T11:44:16.034Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/geo-optimization)
- [Send to Agent page](https://openagent3.xyz/skills/geo-optimization/agent)
- [JSON manifest](https://openagent3.xyz/skills/geo-optimization/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/geo-optimization/agent.md)
- [Download page](https://openagent3.xyz/downloads/geo-optimization)