How malsmadi80/geo-seo-claude works
This repository is a Claude Code skill suite for GEO-first website optimization, with Python utilities and a lightweight prospect CRM. The main workflow starts with a user command, routes through the GEO skill, discovers site information, runs specialized audit analyses, synthesizes findings, and produces reports. Separate command branches cover citability, crawler access, llms.txt, brand visibility, platform optimization, schema, technical SEO, and content. CRM, proposal, and comparison capabilities are documented, but their skill implementations were not sampled; their links are therefore limited to documented relationships. Analysis and routing links follow the README; sampled utility behavior is shown where visible.
Main entry points: agents Parallel Subagents · geo-audit/SKILL.md Full Audit · geo/SKILL.md GEO Command Router · geo-prospect/SKILL.md Prospect Pipeline
Components 22
Command Orchestration
- GEO Command Router
geo/SKILL.md - Full Audit
skills/geo-audit/SKILL.md
Site Analysis
- Site Discovery
scripts/fetch_page.py - Parallel Subagents
agents - Citability Analysis
scripts/citability_scorer.py - Crawler Access
skills/geo-crawlers/SKILL.md - Brand Mentions
scripts/brand_scanner.py - llms.txt Tools
scripts/llmstxt_generator.py - Platform Optimization
skills/geo-platform-optimizer/SKILL.md - Technical SEO
skills/geo-technical/SKILL.md - Content & E-E-A-T
skills/geo-content/SKILL.md - Structured Data
schema
Reports & Guidance
- Score Synthesis
skills/geo-audit/SKILL.md - Markdown Reports
skills/geo-report/SKILL.md - PDF Reports
scripts/generate_pdf_report.py
Client Operations
- Prospect Pipeline
skills/geo-prospect/SKILL.md - CRM Dashboard
scripts/webapp/app.py - CRM CLI
scripts/crm_dashboard.py - Proposals
skills/geo-proposal/SKILL.md - Progress Comparison
skills/geo-compare/SKILL.md - Prospect Data
Other components
- User
Connections 32
- User → GEO Command Router: runs command
README.md - GEO Command Router → Full Audit: routes audit
README.md - Full Audit → Site Discovery: discovers site
README.md - Full Audit → Parallel Subagents: launches parallel
README.md - Parallel Subagents → Citability Analysis: analyzes citations
README.md - Parallel Subagents → Crawler Access: checks access
README.md - Parallel Subagents → Brand Mentions: checks mentions
README.md - Parallel Subagents → llms.txt Tools: analyzes guidance
README.md - Parallel Subagents → Platform Optimization: assesses readiness
README.md - Parallel Subagents → Technical SEO: audits foundations
README.md - Parallel Subagents → Content & E-E-A-T: assesses quality
README.md - Parallel Subagents → Structured Data: analyzes markup
README.md - Full Audit → Score Synthesis: aggregates scores
README.md - Score Synthesis → Markdown Reports: generates findings
README.md - User → Citability Analysis: requests score
README.md - User → Crawler Access: requests check
README.md - User → llms.txt Tools: requests analysis
README.md - User → Brand Mentions: requests scan
README.md - User → Platform Optimization: requests tuning
README.md - User → Technical SEO: requests audit
README.md - User → Content & E-E-A-T: requests review
README.md - User → Structured Data: requests analysis
README.md - User → Markdown Reports: requests report
README.md - User → PDF Reports: requests PDF
README.md - User → Prospect Pipeline: manages prospects
README.md - User → Proposals: requests proposal
README.md - User → Progress Comparison: requests comparison
README.md - Prospect Pipeline → Prospect Data: stores pipeline
README.md - Proposals → Prospect Data: stores proposals
README.md - Progress Comparison → Prospect Data: stores reports
README.md - CRM Dashboard → Prospect Data: reads and writes
scripts/webapp/app.py - CRM CLI → Prospect Data: reads pipeline
README.md