aeo-report

Generate Markdown and HTML visibility reports from local aeo-evidence-v1 JSON files.

9|2|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/psyduckler/aeo-skills --skill aeo-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aeo-report
Source: https://github.com/psyduckler/aeo-skills/tree/main/aeo-report
Command: npx skills add https://github.com/psyduckler/aeo-skills --skill aeo-report

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The aeo-report skill analyzes accumulated baseline evidence to produce a shareable visibility report with trends, decay signals, cannibalization, hub-page opportunities, and competitor share-of-voice shifts, helping brands understand how their AI visibility evolves over time.

Core Features & Use Cases

  • Reads and aggregates data from the local aeo-data/ directory (one or more aeo-evidence-v1 JSON files) to build a historical visibility view.
  • Generates a Markdown report plus a self-contained HTML file with inline SVG charts, suitable for sharing with stakeholders.
  • Detects trend signals such as citation-rate decay, owned-url cannibalization, hub-page opportunities, and competitor share shifts to inform optimization work.
  • Pairs with the broader AEO toolchain (aeo-baseline, aeo-track, aeo-init) for end-to-end visibility measurement and reporting.

Quick Start

Run the report on your existing aeo-data to generate the latest visibility document.

Frequently Asked Questions about aeo-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an AI visibility report from local JSON evidence files?

To generate an AI visibility report, this skill reads local aeo-data/*.json files and aggregates them to produce Markdown and HTML outputs without API calls. It analyzes citation decay, cannibalization, and competitor share-of-voice shifts.

Can I create a shareable HTML dashboard from multiple baseline runs?

Yes, you can create a shareable HTML dashboard from multiple baseline runs. The tool aggregates historical evidence to produce a self-contained HTML file with inline SVG charts suitable for stakeholder sharing.

What is citation-rate decay and how does an AEO report detect it?

Citation-rate decay is a trend signal showing declining AI visibility over time. The report detects this by analyzing accumulated baseline evidence across multiple runs to identify drops in citation rates.

Do I need Python 3.9 or any external API keys to run AEO reporting?

You need Python 3.9 or higher to run AEO reporting, but you do not need external API keys. The tool operates entirely locally by reading aeo-data/*.json files without calling any provider APIs or mutating source evidence.

How do I track competitor share-of-voice shifts in AI search results?

You can track competitor share-of-voice shifts by analyzing accumulated baseline evidence. The report detects these shifts automatically across multiple baseline runs and prompts, providing insights into how competitor visibility evolves.

Why does my visibility report show owned-url cannibalization?

Owned-url cannibalization appears in your visibility report when multiple owned URLs compete for the same AI citations. The tool detects this signal by analyzing accumulated baseline evidence across historical runs to inform optimization work.