# cognitic-labs/geoskills architecture

> Architecture diagram of the GitHub repository cognitic-labs/geoskills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cognitic-labs/geoskills
- Repository: https://github.com/cognitic-labs/geoskills

## Overview

geoskills is a suite of Agent Skills for diagnosing and improving a website’s visibility in AI-powered search. The principal workflow is: a user runs a GEO audit on a site, receives a weighted score and prioritized fixes, then uses the remediation skills; separate skills compare competitors and monitor scores over time. The graph includes the documented audit dimensions and scoring guide, but source excerpts cover no skill instructions, so internal execution and data-flow links are limited to relationships stated in the README.

Main entry points: [`skills/geo-audit/SKILL.md`](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/SKILL.md) (GEO audit), [`skills/geo-fix-content/SKILL.md`](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-fix-content/SKILL.md) (Fix content), [`skills/geo-fix-schema/SKILL.md`](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-fix-schema/SKILL.md) (Fix schema), [`skills/geo-fix-llmstxt/SKILL.md`](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-fix-llmstxt/SKILL.md) (Fix llms.txt)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audit["GEO audit"]
  node_geo_audit["GEO audit<br/>[SKILL.md]"]
  node_scoring["Scoring guide<br/>[scoring-guide.md]"]
end

subgraph group_fixes["Remediation skills"]
  node_fix_content["Fix content<br/>[SKILL.md]"]
  node_fix_schema["Fix schema<br/>[SKILL.md]"]
  node_fix_llmstxt["Fix llms.txt<br/>[SKILL.md]"]
end

subgraph group_analysis["Comparison and monitoring"]
  node_compare["Compare sites<br/>[SKILL.md]"]
  node_monitor["Monitor score<br/>[SKILL.md]"]
end

subgraph group_audit_details["Audit dimensions"]
  node_technical["Technical access<br/>[geo-technical.md]"]
  node_citability["Content citability<br/>[geo-citability.md]"]
  node_structured_data["Structured data<br/>[geo-schema.md]"]
  node_brand_signals["Brand signals<br/>[geo-brand.md]"]
end

node_user(("Site owner"))
node_website["Target website"]

node_user -->|"runs audit"| node_geo_audit
node_website -->|"audits"| node_geo_audit
node_geo_audit -->|"scores with"| node_scoring
node_geo_audit -->|"evaluates"| node_technical
node_geo_audit -->|"evaluates"| node_citability
node_geo_audit -->|"evaluates"| node_structured_data
node_geo_audit -->|"evaluates"| node_brand_signals
node_user -->|"runs fix"| node_fix_content
node_website -->|"provides content"| node_fix_content
node_user -->|"runs fix"| node_fix_schema
node_website -->|"provides site"| node_fix_schema
node_user -->|"runs fix"| node_fix_llmstxt
node_website -->|"provides site"| node_fix_llmstxt
node_user -->|"runs comparison"| node_compare
node_website -->|"compares with"| node_compare
node_user -->|"tracks progress"| node_monitor
node_website -->|"monitors"| node_monitor

click node_geo_audit "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/SKILL.md"
click node_scoring "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/scoring-guide.md"
click node_technical "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/agents/geo-technical.md"
click node_citability "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/agents/geo-citability.md"
click node_structured_data "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/agents/geo-schema.md"
click node_brand_signals "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/agents/geo-brand.md"
click node_fix_content "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-fix-content/SKILL.md"
click node_fix_schema "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-fix-schema/SKILL.md"
click node_fix_llmstxt "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-fix-llmstxt/SKILL.md"
click node_compare "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-compare/SKILL.md"
click node_monitor "https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-monitor/SKILL.md"

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_geo_audit,node_scoring toneBlue
class node_fix_content,node_fix_schema,node_fix_llmstxt toneAmber
class node_compare,node_monitor toneMint
class node_technical,node_citability,node_structured_data,node_brand_signals toneRose
class node_user,node_website toneIndigo
```

## Components

### GEO audit

- [GEO audit](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/SKILL.md): `skills/geo-audit/SKILL.md`
- [Scoring guide](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/scoring-guide.md): `skills/geo-audit/references/scoring-guide.md`

### Remediation skills

- [Fix content](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-fix-content/SKILL.md): `skills/geo-fix-content/SKILL.md`
- [Fix schema](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-fix-schema/SKILL.md): `skills/geo-fix-schema/SKILL.md`
- [Fix llms.txt](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-fix-llmstxt/SKILL.md): `skills/geo-fix-llmstxt/SKILL.md`

### Comparison and monitoring

- [Compare sites](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-compare/SKILL.md): `skills/geo-compare/SKILL.md`
- [Monitor score](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-monitor/SKILL.md): `skills/geo-monitor/SKILL.md`

### Audit dimensions

- [Technical access](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/agents/geo-technical.md): `skills/geo-audit/references/agents/geo-technical.md`
- [Content citability](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/agents/geo-citability.md): `skills/geo-audit/references/agents/geo-citability.md`
- [Structured data](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/agents/geo-schema.md): `skills/geo-audit/references/agents/geo-schema.md`
- [Brand signals](https://github.com/cognitic-labs/geoskills/blob/main/skills/geo-audit/references/agents/geo-brand.md): `skills/geo-audit/references/agents/geo-brand.md`

### Other components

- **Site owner**
- **Target website**

## Connections

- Site owner → GEO audit: runs audit (evidence: `README.md`)
- Target website → GEO audit: audits (evidence: `README.md`)
- GEO audit → Scoring guide: scores with (evidence: `README.md`)
- GEO audit → Technical access: evaluates (evidence: `README.md`)
- GEO audit → Content citability: evaluates (evidence: `README.md`)
- GEO audit → Structured data: evaluates (evidence: `README.md`)
- GEO audit → Brand signals: evaluates (evidence: `README.md`)
- Site owner → Fix content: runs fix (evidence: `README.md`)
- Target website → Fix content: provides content (evidence: `README.md`)
- Site owner → Fix schema: runs fix (evidence: `README.md`)
- Target website → Fix schema: provides site (evidence: `README.md`)
- Site owner → Fix llms.txt: runs fix (evidence: `README.md`)
- Target website → Fix llms.txt: provides site (evidence: `README.md`)
- Site owner → Compare sites: runs comparison (evidence: `README.md`)
- Target website → Compare sites: compares with (evidence: `README.md`)
- Site owner → Monitor score: tracks progress (evidence: `README.md`)
- Target website → Monitor score: monitors (evidence: `README.md`)
