# siddhantsinghrao/claude-seo-skill architecture

> Architecture diagram of the GitHub repository siddhantsinghrao/claude-seo-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/siddhantsinghrao/claude-seo-skill
- Repository: https://github.com/siddhantsinghrao/claude-seo-skill

## Overview

Claude SEO Skills is a bundle of 11 prompt-driven SEO workflows, each with on-demand reference material. The user supplies a URL, keyword, topic, or domain; Claude loads the relevant skill, performs research where appropriate, and produces an audit, plan, or content deliverable. The README documents these behaviors and the bundled-reference pattern; no implementation excerpts were provided, so the graph shows documented relationships only.

Main entry points: [`skills/page-audit/SKILL.md`](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/page-audit/SKILL.md) (Page audit), [`skills/keyword-deep-dive/SKILL.md`](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/keyword-deep-dive/SKILL.md) (Keyword deep dive), [`skills/content-brief/SKILL.md`](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/content-brief/SKILL.md) (Content brief), [`skills/write-content/SKILL.md`](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/write-content/SKILL.md) (Write content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_audits["Audits and diagnostics"]
  node_page_audit["Page audit<br/>[SKILL.md]"]
  node_page_audit_refs["Audit references"]
  node_eeat_audit["E-E-A-T audit<br/>[SKILL.md]"]
  node_eeat_refs["E-E-A-T references"]
  node_semantic_gap["Semantic gap<br/>[SKILL.md]"]
  node_semantic_refs["Gap references"]
end

subgraph group_research["Research and planning"]
  node_keyword_dive["Keyword deep dive<br/>[SKILL.md]"]
  node_keyword_refs["Keyword references"]
  node_content_brief["Content brief<br/>[SKILL.md]"]
  node_brief_refs["Brief references"]
  node_cluster_plan["Topic cluster plan<br/>[SKILL.md]"]
  node_cluster_refs["Cluster references"]
  node_snippet_optimizer["Snippet optimizer<br/>[SKILL.md]"]
  node_snippet_refs["Snippet references"]
end

subgraph group_content["Content production"]
  node_write_content["Write content<br/>[SKILL.md]"]
  node_write_refs["Writing references"]
  node_improve_content["Improve content<br/>[SKILL.md]"]
  node_improve_refs["Improvement references"]
  node_expert_interview["Expert interview<br/>[SKILL.md]"]
  node_interview_refs["Interview references"]
end

subgraph group_authority["Authority building"]
  node_linkbuilding["Linkbuilding plan<br/>[SKILL.md]"]
  node_link_refs["Linkbuilding references"]
end

node_user(("SEO practitioner"))
node_claude["Claude agent"]

node_user -->|"provides input"| node_claude
node_claude -->|"loads skill"| node_page_audit
node_claude -->|"loads skill"| node_eeat_audit
node_claude -->|"loads skill"| node_semantic_gap
node_claude -->|"loads skill"| node_keyword_dive
node_claude -->|"loads skill"| node_content_brief
node_claude -->|"loads skill"| node_cluster_plan
node_claude -->|"loads skill"| node_snippet_optimizer
node_claude -->|"loads skill"| node_write_content
node_claude -->|"loads skill"| node_improve_content
node_claude -->|"loads skill"| node_expert_interview
node_claude -->|"loads skill"| node_linkbuilding
node_page_audit -->|"loads on demand"| node_page_audit_refs
node_eeat_audit -->|"loads on demand"| node_eeat_refs
node_semantic_gap -->|"loads on demand"| node_semantic_refs
node_keyword_dive -->|"loads on demand"| node_keyword_refs
node_content_brief -->|"loads on demand"| node_brief_refs
node_cluster_plan -->|"loads on demand"| node_cluster_refs
node_snippet_optimizer -->|"loads on demand"| node_snippet_refs
node_write_content -->|"loads on demand"| node_write_refs
node_improve_content -->|"loads on demand"| node_improve_refs
node_expert_interview -->|"loads on demand"| node_interview_refs
node_linkbuilding -->|"loads on demand"| node_link_refs
node_claude -->|"researches URL"| node_page_audit
node_claude -->|"researches keyword"| node_content_brief
node_claude -->|"reads SERP"| node_keyword_dive
node_claude -->|"researches topic"| node_write_content
node_page_audit -->|"returns audit"| node_user
node_content_brief -->|"returns brief"| node_user
node_keyword_dive -->|"returns plan"| node_user
node_write_content -->|"returns article"| node_user
node_improve_content -->|"returns rewrite"| node_user
node_semantic_gap -->|"returns gaps"| node_user
node_eeat_audit -->|"returns fixes"| node_user
node_cluster_plan -->|"returns architecture"| node_user
node_snippet_optimizer -->|"returns rewrite"| node_user
node_linkbuilding -->|"returns tactics"| node_user
node_expert_interview -->|"returns expertise"| node_user

click node_page_audit "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/page-audit/SKILL.md"
click node_page_audit_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/page-audit/references"
click node_eeat_audit "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/eeat-audit/SKILL.md"
click node_eeat_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/eeat-audit/references"
click node_semantic_gap "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/semantic-gap-analysis/SKILL.md"
click node_semantic_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/semantic-gap-analysis/references"
click node_keyword_dive "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/keyword-deep-dive/SKILL.md"
click node_keyword_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/keyword-deep-dive/references"
click node_content_brief "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/content-brief/SKILL.md"
click node_brief_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/content-brief/references"
click node_cluster_plan "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/topic-cluster-planning/SKILL.md"
click node_cluster_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/topic-cluster-planning/references"
click node_snippet_optimizer "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/featured-snippet-optimizer/SKILL.md"
click node_snippet_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/featured-snippet-optimizer/references"
click node_write_content "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/write-content/SKILL.md"
click node_write_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/write-content/references"
click node_improve_content "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/improve-content/SKILL.md"
click node_improve_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/improve-content/references"
click node_expert_interview "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/expert-interview/SKILL.md"
click node_interview_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/expert-interview/references"
click node_linkbuilding "https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/linkbuilding/SKILL.md"
click node_link_refs "https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/linkbuilding/references"

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_page_audit,node_page_audit_refs,node_eeat_audit,node_eeat_refs,node_semantic_gap,node_semantic_refs toneBlue
class node_keyword_dive,node_keyword_refs,node_content_brief,node_brief_refs,node_cluster_plan,node_cluster_refs,node_snippet_optimizer,node_snippet_refs toneAmber
class node_write_content,node_write_refs,node_improve_content,node_improve_refs,node_expert_interview,node_interview_refs toneMint
class node_linkbuilding,node_link_refs toneRose
class node_user,node_claude toneIndigo
```

## Components

### Audits and diagnostics

- [Page audit](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/page-audit/SKILL.md): `skills/page-audit/SKILL.md`
- [Audit references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/page-audit/references): `skills/page-audit/references`
- [E-E-A-T audit](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/eeat-audit/SKILL.md): `skills/eeat-audit/SKILL.md`
- [E-E-A-T references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/eeat-audit/references): `skills/eeat-audit/references`
- [Semantic gap](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/semantic-gap-analysis/SKILL.md): `skills/semantic-gap-analysis/SKILL.md`
- [Gap references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/semantic-gap-analysis/references): `skills/semantic-gap-analysis/references`

### Research and planning

- [Keyword deep dive](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/keyword-deep-dive/SKILL.md): `skills/keyword-deep-dive/SKILL.md`
- [Keyword references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/keyword-deep-dive/references): `skills/keyword-deep-dive/references`
- [Content brief](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/content-brief/SKILL.md): `skills/content-brief/SKILL.md`
- [Brief references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/content-brief/references): `skills/content-brief/references`
- [Topic cluster plan](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/topic-cluster-planning/SKILL.md): `skills/topic-cluster-planning/SKILL.md`
- [Cluster references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/topic-cluster-planning/references): `skills/topic-cluster-planning/references`
- [Snippet optimizer](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/featured-snippet-optimizer/SKILL.md): `skills/featured-snippet-optimizer/SKILL.md`
- [Snippet references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/featured-snippet-optimizer/references): `skills/featured-snippet-optimizer/references`

### Content production

- [Write content](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/write-content/SKILL.md): `skills/write-content/SKILL.md`
- [Writing references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/write-content/references): `skills/write-content/references`
- [Improve content](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/improve-content/SKILL.md): `skills/improve-content/SKILL.md`
- [Improvement references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/improve-content/references): `skills/improve-content/references`
- [Expert interview](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/expert-interview/SKILL.md): `skills/expert-interview/SKILL.md`
- [Interview references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/expert-interview/references): `skills/expert-interview/references`

### Authority building

- [Linkbuilding plan](https://github.com/siddhantsinghrao/claude-seo-skill/blob/main/skills/linkbuilding/SKILL.md): `skills/linkbuilding/SKILL.md`
- [Linkbuilding references](https://github.com/siddhantsinghrao/claude-seo-skill/tree/main/skills/linkbuilding/references): `skills/linkbuilding/references`

### Other components

- **SEO practitioner**
- **Claude agent**

## Connections

- SEO practitioner → Claude agent: provides input (evidence: `README.md`)
- Claude agent → Page audit: loads skill (evidence: `README.md`)
- Claude agent → E-E-A-T audit: loads skill (evidence: `README.md`)
- Claude agent → Semantic gap: loads skill (evidence: `README.md`)
- Claude agent → Keyword deep dive: loads skill (evidence: `README.md`)
- Claude agent → Content brief: loads skill (evidence: `README.md`)
- Claude agent → Topic cluster plan: loads skill (evidence: `README.md`)
- Claude agent → Snippet optimizer: loads skill (evidence: `README.md`)
- Claude agent → Write content: loads skill (evidence: `README.md`)
- Claude agent → Improve content: loads skill (evidence: `README.md`)
- Claude agent → Expert interview: loads skill (evidence: `README.md`)
- Claude agent → Linkbuilding plan: loads skill (evidence: `README.md`)
- Page audit → Audit references: loads on demand (evidence: `README.md`)
- E-E-A-T audit → E-E-A-T references: loads on demand (evidence: `README.md`)
- Semantic gap → Gap references: loads on demand (evidence: `README.md`)
- Keyword deep dive → Keyword references: loads on demand (evidence: `README.md`)
- Content brief → Brief references: loads on demand (evidence: `README.md`)
- Topic cluster plan → Cluster references: loads on demand (evidence: `README.md`)
- Snippet optimizer → Snippet references: loads on demand (evidence: `README.md`)
- Write content → Writing references: loads on demand (evidence: `README.md`)
- Improve content → Improvement references: loads on demand (evidence: `README.md`)
- Expert interview → Interview references: loads on demand (evidence: `README.md`)
- Linkbuilding plan → Linkbuilding references: loads on demand (evidence: `README.md`)
- Claude agent → Page audit: researches URL (evidence: `README.md`)
- Claude agent → Content brief: researches keyword (evidence: `README.md`)
- Claude agent → Keyword deep dive: reads SERP (evidence: `README.md`)
- Claude agent → Write content: researches topic (evidence: `README.md`)
- Page audit → SEO practitioner: returns audit (evidence: `README.md`)
- Content brief → SEO practitioner: returns brief (evidence: `README.md`)
- Keyword deep dive → SEO practitioner: returns plan (evidence: `README.md`)
- Write content → SEO practitioner: returns article (evidence: `README.md`)
- Improve content → SEO practitioner: returns rewrite (evidence: `README.md`)
- Semantic gap → SEO practitioner: returns gaps (evidence: `README.md`)
- E-E-A-T audit → SEO practitioner: returns fixes (evidence: `README.md`)
- Topic cluster plan → SEO practitioner: returns architecture (evidence: `README.md`)
- Snippet optimizer → SEO practitioner: returns rewrite (evidence: `README.md`)
- Linkbuilding plan → SEO practitioner: returns tactics (evidence: `README.md`)
- Expert interview → SEO practitioner: returns expertise (evidence: `README.md`)
