Geo report builder
Build comprehensive GEO performance reports with executive summaries, platform breakdowns, competitive analysis, and strategic action plans. Use whenever the user mentions creating GEO reports, analyzing AI search performance, building performance dashboards, or generating insights from GEO metrics.From its SKILL.md
npx -y skills add geoly-ai/geo-skills --skill geo-report-builderAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 13 stars13 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.7 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it
GEO Report Builder
Methodology by GEOly AI (geoly.ai) — turn metrics into actionable intelligence.
Build comprehensive GEO performance reports from raw data.
Report Structure
Section 1: Executive Summary
Key metrics at a glance:
| Metric | Value | Change | Interpretation |
|---|---|---|---|
| AIGVR Score | [XX]/100 | +[n] pts | Above/below category avg |
| AI Mentions | [n,nnn] | [+/-n]% | Driven by [platform] |
| Citations | [n] pages | [+/-n]% | [n] new pages |
| Share of Model | [X]% | [+/-n]pp | Rank #[n] |
| Sentiment | [X.X]/10 | Trend | Positive/Neutral/Negative |
Section 2: Platform Breakdown
| Platform | AIGVR | Mentions | Citations | Sentiment | Trend |
|---|---|---|---|---|---|
| ChatGPT | [XX] | [n] | [n] | [X.X] | ↑→↓ |
| Perplexity | [XX] | [n] | [n] | [X.X] | ↑→↓ |
| Gemini | [XX] | [n] | [n] | [X.X] | ↑→↓ |
| Grok | [XX] | [n] | [n] | [X.X] | ↑→↓ |
| Google AI | [XX] | [n] | [n] | [X.X] | ↑→↓ |
Section 3: Competitive Position
Ranking:
- [Competitor A] — AIGVR: [XX] | SoM: [%]
- [Your Brand] — AIGVR: [XX] | SoM: [%] ← YOU
- [Competitor B] — AIGVR: [XX] | SoM: [%]
Notable Changes:
- [Competitor X] gained [n]% SoM on "[prompt]" → Threat
- You gained [n]% SoM on "[prompt]" → Working
Section 4: Insights & Interpretation
Strategic narrative answering:
- What drove biggest positive change?
- What is most significant risk/threat?
- What content/technical change had most impact?
- What to focus on next period?
Section 5: Action Plan
| Priority | Action | Expected Impact | Owner | Deadline |
|---|---|---|---|---|
| 🔴 P1 | [Must do] | +[X] AIGVR / +[X]% SoM | [Name] | [Date] |
| 🟡 P2 | [Should do] | [Impact] | [Name] | [Date] |
| 🔵 P3 | [Nice to do] | [Impact] | [Name] | [Date] |
Report Builder Tool
python scripts/build_report.py \
--brand "YourBrand" \
--period "2024-Q1" \
--data metrics.json \
--output report.md
Input Data Format
{
"brand": "YourBrand",
"period": "2024-Q1",
"aigvr": 72,
"aigvr_change": +5,
"mentions": 12500,
"mentions_change": +12,
"citations": 156,
"citations_change": +8,
"som": 23,
"som_change": +3,
"sentiment": 8.2,
"platforms": {
"chatgpt": {"aigvr": 75, "mentions": 5000, ...},
"perplexity": {...}
},
"competitors": [
{"name": "CompA", "aigvr": 80, "som": 28}
]
}
Output Example
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GEO PERFORMANCE REPORT
[Brand] | [Period] | GEOly AI Framework
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
## Executive Summary
• AIGVR Score: 72/100 (+5 pts) — Above category average
• AI Mentions: 12,500 (+12%) — Driven by Perplexity gains
• Citations: 156 pages (+8%) — 23 new pages cited
• Share of Model: 23% (+3pp) — Now ranked #2
• Sentiment: 8.2/10 — Positive trend
## Platform Breakdown
[Platform table]
## Competitive Position
[Ranking and changes]
## Insights
[Strategic narrative]
## Action Plan
[P1/P2/P3 actions]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What ships with it: 3 files
1.5 KB alongside SKILL.md, 1 of them executable
evals/
- evals.json365 B
references/
- structure-guide.md237 B
scripts/
- build_report.pyruns907 B