# garrettjsmith/localseoskills architecture

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

- Interactive diagram: https://gitdiagram.com/garrettjsmith/localseoskills
- Repository: https://github.com/garrettjsmith/localseoskills

## Overview

Local SEO Skills is a collection of agent-readable skills and task templates for local SEO client work, not a standalone server. A user request is routed to relevant strategy skills, which can use tool skills and connected data sources to produce audits, monitoring, and reports. Briefs preserve per-location work state; scheduled task templates support recurring monitoring, reporting, and execution. The graph reflects relationships documented in the README; source excerpts were not provided, so implementation-level calls are not inferred.

Main entry points: [`skills`](https://github.com/garrettjsmith/localseoskills/tree/main/skills) (Strategy skills), [`skills/dispatch`](https://github.com/garrettjsmith/localseoskills/tree/main/skills/dispatch) (Skill dispatch), [`skills/multi-location-seo`](https://github.com/garrettjsmith/localseoskills/tree/main/skills/multi-location-seo) (Multi-location SEO), [`skills/localseodata-tool`](https://github.com/garrettjsmith/localseoskills/tree/main/skills/localseodata-tool) (Local SEO Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Agent workflow"]
  node_agent["Compatible agent"]
  node_dispatch["Skill dispatch"]
end

subgraph group_expertise["SEO expertise"]
  node_strategy["Strategy skills"]
  node_audit["SEO audits"]
  node_gbp["GBP optimization"]
  node_visibility["AI visibility"]
  node_geo["Geogrid analysis"]
  node_content["Content strategy"]
  node_multi["Multi-location SEO"]
end

subgraph group_data["Data access"]
  node_toolskills["Tool skills"]
  node_localdata["Local SEO Data"]
  node_specialists["Specialist tools"]
end

subgraph group_operations["Client operations"]
  node_briefs["Persistent briefs"]
  node_tasks["Scheduled tasks"]
  node_deliverables["Client deliverables"]
end

node_user(("SEO practitioner"))
node_externaldata{{"Connected data services"}}
node_cloud["Task runtime"]

node_user -->|"requests work"| node_agent
node_agent -->|"selects skills"| node_dispatch
node_dispatch -->|"routes requests"| node_strategy
node_strategy -->|"includes audits"| node_audit
node_strategy -->|"includes GBP"| node_gbp
node_strategy -->|"includes AI search"| node_visibility
node_strategy -->|"includes geogrids"| node_geo
node_strategy -->|"includes content"| node_content
node_strategy -->|"includes multi-location"| node_multi
node_agent -->|"reads and updates"| node_briefs
node_agent -->|"uses integrations"| node_toolskills
node_toolskills -->|"includes default"| node_localdata
node_toolskills -->|"includes alternatives"| node_specialists
node_localdata -->|"connects by MCP"| node_externaldata
node_specialists -->|"connects tools"| node_externaldata
node_agent -->|"configures tasks"| node_tasks
node_tasks -->|"runs on"| node_cloud
node_agent -->|"prepares outputs"| node_deliverables
node_multi -->|"tracks locations"| node_briefs

click node_dispatch "https://github.com/garrettjsmith/localseoskills/tree/main/skills/dispatch"
click node_strategy "https://github.com/garrettjsmith/localseoskills/tree/main/skills"
click node_audit "https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-seo-audit"
click node_gbp "https://github.com/garrettjsmith/localseoskills/tree/main/skills/gbp-optimization"
click node_visibility "https://github.com/garrettjsmith/localseoskills/tree/main/skills/ai-local-search"
click node_geo "https://github.com/garrettjsmith/localseoskills/tree/main/skills/geogrid-analysis"
click node_content "https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-content-strategy"
click node_multi "https://github.com/garrettjsmith/localseoskills/tree/main/skills/multi-location-seo"
click node_toolskills "https://github.com/garrettjsmith/localseoskills/tree/main/skills"
click node_localdata "https://github.com/garrettjsmith/localseoskills/tree/main/skills/localseodata-tool"
click node_specialists "https://github.com/garrettjsmith/localseoskills/tree/main/skills"
click node_briefs "https://github.com/garrettjsmith/localseoskills/tree/main/briefs"
click node_tasks "https://github.com/garrettjsmith/localseoskills/tree/main/tasks"
click node_deliverables "https://github.com/garrettjsmith/localseoskills/tree/main/skills/client-deliverables"

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_agent,node_dispatch toneBlue
class node_strategy,node_audit,node_gbp,node_visibility,node_geo,node_content,node_multi toneAmber
class node_toolskills,node_localdata,node_specialists toneMint
class node_briefs,node_tasks,node_deliverables,node_cloud toneRose
class node_user,node_externaldata toneIndigo
```

## Components

### Agent workflow

- **Compatible agent**
- [Skill dispatch](https://github.com/garrettjsmith/localseoskills/tree/main/skills/dispatch): `skills/dispatch`

### SEO expertise

- [Strategy skills](https://github.com/garrettjsmith/localseoskills/tree/main/skills): `skills`
- [SEO audits](https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-seo-audit): `skills/local-seo-audit`
- [GBP optimization](https://github.com/garrettjsmith/localseoskills/tree/main/skills/gbp-optimization): `skills/gbp-optimization`
- [AI visibility](https://github.com/garrettjsmith/localseoskills/tree/main/skills/ai-local-search): `skills/ai-local-search`
- [Geogrid analysis](https://github.com/garrettjsmith/localseoskills/tree/main/skills/geogrid-analysis): `skills/geogrid-analysis`
- [Content strategy](https://github.com/garrettjsmith/localseoskills/tree/main/skills/local-content-strategy): `skills/local-content-strategy`
- [Multi-location SEO](https://github.com/garrettjsmith/localseoskills/tree/main/skills/multi-location-seo): `skills/multi-location-seo`

### Data access

- [Tool skills](https://github.com/garrettjsmith/localseoskills/tree/main/skills): `skills`
- [Local SEO Data](https://github.com/garrettjsmith/localseoskills/tree/main/skills/localseodata-tool): `skills/localseodata-tool`
- [Specialist tools](https://github.com/garrettjsmith/localseoskills/tree/main/skills): `skills`

### Client operations

- [Persistent briefs](https://github.com/garrettjsmith/localseoskills/tree/main/briefs): `briefs`
- [Scheduled tasks](https://github.com/garrettjsmith/localseoskills/tree/main/tasks): `tasks`
- [Client deliverables](https://github.com/garrettjsmith/localseoskills/tree/main/skills/client-deliverables): `skills/client-deliverables`

### Other components

- **SEO practitioner**
- **Connected data services**
- **Task runtime**

## Connections

- SEO practitioner → Compatible agent: requests work (evidence: `README.md`)
- Compatible agent → Skill dispatch: selects skills (evidence: `README.md`)
- Skill dispatch → Strategy skills: routes requests (evidence: `README.md`)
- Strategy skills → SEO audits: includes audits (evidence: `README.md`)
- Strategy skills → GBP optimization: includes GBP (evidence: `README.md`)
- Strategy skills → AI visibility: includes AI search (evidence: `README.md`)
- Strategy skills → Geogrid analysis: includes geogrids (evidence: `README.md`)
- Strategy skills → Content strategy: includes content (evidence: `README.md`)
- Strategy skills → Multi-location SEO: includes multi-location (evidence: `README.md`)
- Compatible agent → Persistent briefs: reads and updates (evidence: `README.md`)
- Compatible agent → Tool skills: uses integrations (evidence: `README.md`)
- Tool skills → Local SEO Data: includes default (evidence: `README.md`)
- Tool skills → Specialist tools: includes alternatives (evidence: `README.md`)
- Local SEO Data → Connected data services: connects by MCP (evidence: `README.md`)
- Specialist tools → Connected data services: connects tools (evidence: `README.md`)
- Compatible agent → Scheduled tasks: configures tasks (evidence: `README.md`)
- Scheduled tasks → Task runtime: runs on (evidence: `README.md`)
- Compatible agent → Client deliverables: prepares outputs (evidence: `README.md`)
- Multi-location SEO → Persistent briefs: tracks locations (evidence: `README.md`)
