GEO Performance Report Builder

Build comprehensive GEO performance reports with executive summaries, platform breakdowns, competitive analysis, and strategic action plans. Use whenever the...

Security Scan

The package is not malicious, but the implementation and instructions are inconsistent with the ambitious description — it overpromises and contains input-schema mismatches and provenance gaps that make its behavior unclear.

Purpose & Capability

The skill description promises a comprehensive, 5-section GEO performance report with platform breakdowns, competitive analysis, narratives, and action plans. The included script is very small and only emits a short markdown report using a few top-level fields (aigvr, mentions, som, sentiment, chatgpt, perplexity). The SKILL.md examples show nested 'platforms' objects and fields like 'aigvr_change' and competitor arrays that the script does not parse. This is an overpromise / capability mismatch: the files do not implement the full described functionality.

Instruction Scope

Runtime instructions are narrow and explicit: run the provided Python script against a local JSON file. The instructions do not attempt to read arbitrary system files, environment variables, or call external endpoints. However, SKILL.md contains a broad trigger line ('Use whenever the user mentions...') which could cause the agent to run this skill automatically in many contexts — combined with the capability mismatch, that could produce misleading outputs when invoked autonomously.

Install Mechanism

No install spec and no network downloads; this is an instruction-only skill with one small local script. Nothing is written to disk by an installer or fetched from external URLs during installation.

Credentials

The skill requests no environment variables, no credentials, and no config paths. The script operates only on a user-supplied local JSON file. There is no obvious request for secrets or unrelated credentials.

Persistence & Privilege

always is false and the skill does not request persistent system privileges. It can be autonomously invoked by the agent (default platform behavior), which is normal; consider the broad trigger in the SKILL.md when deciding whether to enable autonomous invocation.

What to consider before installing

This skill is not hostile, but it appears to overpromise and is incomplete. Before installing or relying on it: 1) Note provenance: source is unknown and there is no homepage—treat it as unvetted. 2) Test locally with representative JSON: the included script expects top-level keys like 'chatgpt' and 'perplexity', but SKILL.md shows a nested 'platforms' object and competitor arrays; adapt the script or reshape your input so fields match. 3) The SKILL.md examples use '+5' style annotations which are not valid JSON—ensure your metrics file uses plain numbers. 4) If you plan to allow autonomous invocation, be aware the trigger wording is broad and the script can produce incomplete/misleading reports when run automatically. 5) If you need the full advertised functionality (competitive narratives, platform-level detail), either extend the script yourself or get a version from a verifiable source. If you're unsure, run the code in a sandboxed environment and inspect/modify the script before use.

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:

1. [Competitor A] — AIGVR: [XX] | SoM: [%]
2. [Your Brand] — AIGVR: [XX] | SoM: [%] ← YOU
3. [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:

1. What drove biggest positive change?
2. What is most significant risk/threat?
3. What content/technical change had most impact?
4. 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]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━