# spirizeon/agentic-aeo-skills architecture

> Architecture diagram of the GitHub repository spirizeon/agentic-aeo-skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/spirizeon/agentic-aeo-skills
- Repository: https://github.com/spirizeon/agentic-aeo-skills

## Overview

AEO-Skills is a collection of agent-facing AEO guidance and standalone command-line audit tools, not a hosted service. The main user workflow is to choose an audit or measurement task, run the relevant checker against a site or local input, and inspect its report or structured output. The benchmark combines several site checks into category scores; separate tools validate robots.txt and llms.txt, estimate documentation token use, and analyze server logs for AI traffic. README documents the skill catalog and supported agent platforms; skill internals were not sampled.

Main entry points: [`scripts/aeo_benchmark.py`](https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/aeo_benchmark.py) (AEO Benchmark), [`scripts/llms_txt_checker.py`](https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/llms_txt_checker.py) (llms.txt Validator), [`scripts/robots_checker.py`](https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/robots_checker.py) (Robots Validator), [`scripts/token_counter.py`](https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/token_counter.py) (Token Counter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_skills["Agent Skills"]
  node_skill_audit["AEO Audit Skill<br/>[SKILL.md]"]
  node_skill_benchmark["Benchmark Skill<br/>[SKILL.md]"]
  node_skill_traffic["Traffic Skill<br/>[SKILL.md]"]
  node_skill_llms["llms.txt Skill<br/>[SKILL.md]"]
  node_skill_tokens["Token Skill<br/>[SKILL.md]"]
end

subgraph group_audit["Site Audits"]
  node_benchmark["AEO Benchmark<br/>[aeo_benchmark.py]"]
  node_llms_check["llms.txt Validator"]
  node_robots_check["Robots Validator<br/>[robots_checker.py]"]
end

subgraph group_measure["Measurement Tools"]
  node_token_counter["Token Counter<br/>[token_counter.py]"]
end

subgraph group_traffic["Traffic Analysis"]
  node_traffic_detector["Traffic Detector"]
end

node_user(("Engineer"))
node_agent(("Coding Agent"))
node_site(("Target Website"))
node_server_logs["Server Logs"]

node_user -->|"uses skills"| node_agent
node_agent -->|"selects"| node_skill_audit
node_agent -->|"selects"| node_skill_benchmark
node_agent -->|"selects"| node_skill_traffic
node_agent -->|"selects"| node_skill_llms
node_agent -->|"selects"| node_skill_tokens
node_user -->|"runs benchmark"| node_benchmark
node_benchmark -->|"fetches site data"| node_site
node_benchmark -->|"checks llms.txt"| node_llms_check
node_benchmark -->|"checks robots.txt"| node_robots_check
node_user -->|"runs validator"| node_llms_check
node_llms_check -->|"fetches llms.txt"| node_site
node_user -->|"runs validator"| node_robots_check
node_robots_check -->|"fetches robots.txt"| node_site
node_user -->|"counts tokens"| node_token_counter
node_token_counter -->|"fetches content"| node_site
node_user -->|"analyzes traffic"| node_traffic_detector
node_traffic_detector -->|"reads logs"| node_server_logs

click node_skill_audit "https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/aeo-audit/SKILL.md"
click node_skill_benchmark "https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/aeo-benchmark/SKILL.md"
click node_skill_traffic "https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/ai-traffic-detector/SKILL.md"
click node_skill_llms "https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/llms-txt-checker/SKILL.md"
click node_skill_tokens "https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/token-counter/SKILL.md"
click node_benchmark "https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/aeo_benchmark.py"
click node_llms_check "https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/llms_txt_checker.py"
click node_robots_check "https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/robots_checker.py"
click node_token_counter "https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/token_counter.py"
click node_traffic_detector "https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/ai_traffic_detector.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill_audit,node_skill_benchmark,node_skill_traffic,node_skill_llms,node_skill_tokens toneBlue
class node_benchmark,node_llms_check,node_robots_check toneAmber
class node_token_counter,node_server_logs toneMint
class node_traffic_detector toneRose
class node_user,node_agent,node_site toneIndigo
```

## Components

### Agent Skills

- [AEO Audit Skill](https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/aeo-audit/SKILL.md): `.claude/skills/aeo-audit/SKILL.md`
- [Benchmark Skill](https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/aeo-benchmark/SKILL.md): `.claude/skills/aeo-benchmark/SKILL.md`
- [Traffic Skill](https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/ai-traffic-detector/SKILL.md): `.claude/skills/ai-traffic-detector/SKILL.md`
- [llms.txt Skill](https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/llms-txt-checker/SKILL.md): `.claude/skills/llms-txt-checker/SKILL.md`
- [Token Skill](https://github.com/spirizeon/agentic-aeo-skills/blob/main/.claude/skills/token-counter/SKILL.md): `.claude/skills/token-counter/SKILL.md`

### Site Audits

- [AEO Benchmark](https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/aeo_benchmark.py): `scripts/aeo_benchmark.py`
- [llms.txt Validator](https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/llms_txt_checker.py): `scripts/llms_txt_checker.py`
- [Robots Validator](https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/robots_checker.py): `scripts/robots_checker.py`

### Measurement Tools

- [Token Counter](https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/token_counter.py): `scripts/token_counter.py`

### Traffic Analysis

- [Traffic Detector](https://github.com/spirizeon/agentic-aeo-skills/blob/main/scripts/ai_traffic_detector.py): `scripts/ai_traffic_detector.py`

### Other components

- **Engineer**
- **Coding Agent**
- **Target Website**
- **Server Logs**

## Connections

- Engineer → Coding Agent: uses skills (evidence: `README.md`)
- Coding Agent → AEO Audit Skill: selects (evidence: `README.md`)
- Coding Agent → Benchmark Skill: selects (evidence: `README.md`)
- Coding Agent → Traffic Skill: selects (evidence: `README.md`)
- Coding Agent → llms.txt Skill: selects (evidence: `README.md`)
- Coding Agent → Token Skill: selects (evidence: `README.md`)
- Engineer → AEO Benchmark: runs benchmark (evidence: `README.md`)
- AEO Benchmark → Target Website: fetches site data (evidence: `scripts/aeo_benchmark.py`)
- AEO Benchmark → llms.txt Validator: checks llms.txt (evidence: `README.md`)
- AEO Benchmark → Robots Validator: checks robots.txt (evidence: `README.md`)
- Engineer → llms.txt Validator: runs validator (evidence: `README.md`)
- llms.txt Validator → Target Website: fetches llms.txt (evidence: `scripts/llms_txt_checker.py`)
- Engineer → Robots Validator: runs validator (evidence: `README.md`)
- Robots Validator → Target Website: fetches robots.txt (evidence: `scripts/robots_checker.py`)
- Engineer → Token Counter: counts tokens (evidence: `README.md`)
- Token Counter → Target Website: fetches content (evidence: `scripts/token_counter.py`)
- Engineer → Traffic Detector: analyzes traffic (evidence: `README.md`)
- Traffic Detector → Server Logs: reads logs (evidence: `scripts/ai_traffic_detector.py`)