# seoskillsai.com — Full Technical Architecture & Knowledge Schema

> Comprehensive technical specification, data dictionary, agent configuration schemas, and URL registry for seoskillsai.com.

---

## 1. Technical Stack & Architecture

- **Framework**: Astro 5.x (Static Site Generation / Islands Architecture)
- **Runtime Performance**: 0.0 KB Hydrated Client-Side JavaScript on static views
- **Styling Engine**: CSS Custom Properties with HSL semantic color tokens
- **Type Safety**: TypeScript 5.9 with strict typecheck validation
- **Structured Data**: Schema.org 2026 JSON-LD graph standards (@graph, TechArticle, SoftwareApplication, FAQPage, BreadcrumbList)
- **Robots & Crawl Policy**: max-image-preview:large, max-snippet:-1, full LLM attribution permissions
- **Licensing**: 100% Free Open-Source (MIT License)

---

## 2. Capability Taxonomy & Category Schema

| Category | Description | Primary Focus |
|---|---|---|
| **Technical & Crawl** | Low-level HTTP, rendering, sitemaps, and indexing | Core Web Vitals, Status Codes, Hreflang, Indexing APIs |
| **Content & Entities** | Semantic entity grounding, copywriting, and factuality | Wikipedia Triples, Heading Trees, Semantic Depth, Tone |
| **Structured Data** | Schema.org JSON-LD graphs and rich snippet eligibility | Nested Graphs, DefinedTerm, SoftwareApplication, FAQs |
| **Strategy & Workflows** | Multi-agent recursive prompt flows and topical roadmaps | Topical Authority Maps, Competitor Scraping, SXO |
| **GEO & Future Search** | Generative search engines and LLM retrieval optimization | Perplexity AI, SearchGPT, Google AI Overviews, Vector Embeddings |

---

## 3. The 12 Supported AI Coding Agent Ecosystems

### 1. Anthropic Claude Code (MCP)
- **Runtime**: Claude Code CLI / Claude Desktop MCP
- **Config**: `claude_desktop_config.json`
- **CLI Command**: `npx @seoskillsai/cli add claude --all`
- **URL**: `https://seoskillsai.com/claude`

### 2. Google Antigravity IDE
- **Runtime**: Antigravity IDE / AGY CLI / Gemini 2.5 Pro
- **Config**: `.agent/skills/seo-skills/SKILL.md`
- **CLI Command**: `npx @seoskillsai/cli add antigravity --all`
- **URL**: `https://seoskillsai.com/antigravity`

### 3. OpenAI ChatGPT
- **Runtime**: ChatGPT Plus / Team Actions / Custom GPTs
- **Config**: `openapi-schema.json`
- **CLI Command**: `npx @seoskillsai/cli export chatgpt-actions`
- **URL**: `https://seoskillsai.com/chatgpt`

### 4. Cursor IDE
- **Runtime**: Cursor IDE / Composer / Agent Mode
- **Config**: `.cursorrules`
- **CLI Command**: `npx @seoskillsai/cli add cursor --all`
- **URL**: `https://seoskillsai.com/cursor`

### 5. Windsurf IDE
- **Runtime**: Windsurf IDE / Codeium Cascade
- **Config**: `.windsurfrules`
- **CLI Command**: `npx @seoskillsai/cli add windsurf --all`
- **URL**: `https://seoskillsai.com/windsurf`

### 6. Cline VS Code
- **Runtime**: VS Code Cline Autonomous MCP Extension
- **Config**: `cline_mcp_settings.json`
- **CLI Command**: `npx @seoskillsai/cli add cline --all`
- **URL**: `https://seoskillsai.com/cline`

### 7. DeepSeek AI
- **Runtime**: DeepSeek R1 / V3 Reasoning API
- **Config**: `deepseek_seo_prompt.md`
- **CLI Command**: `npx @seoskillsai/cli run deepseek-audit`
- **URL**: `https://seoskillsai.com/deepseek`

### 8. Nous Hermes Agent
- **Runtime**: Ollama / vLLM / Local CLI (100% On-Premise)
- **Config**: `hermes_agent_tools.json`
- **CLI Command**: `npx @seoskillsai/cli add hermes --local`
- **URL**: `https://seoskillsai.com/hermes`

### 9. xAI Grok
- **Runtime**: xAI API / Grok CLI / Real-Time X Firehose
- **Config**: `grok_realtime_config.json`
- **CLI Command**: `npx @seoskillsai/cli run grok-trend-seo`
- **URL**: `https://seoskillsai.com/grok`

### 10. Perplexity Pro
- **Runtime**: Perplexity Search API / Pro Search
- **Config**: `perplexity_geo_rules.md`
- **CLI Command**: `npx @seoskillsai/cli run geo-citation-audit`
- **URL**: `https://seoskillsai.com/perplexity`

### 11. Aider CLI
- **Runtime**: Aider Terminal AI Pair Programmer
- **Config**: `.aider.conf.yml`
- **CLI Command**: `aider --model claude-3-5-sonnet`
- **URL**: `https://seoskillsai.com/aider`

### 12. Moonshot Kimi
- **Runtime**: Moonshot Kimi 2M Token Context API
- **Config**: `kimi_context_config.json`
- **CLI Command**: `npx @seoskillsai/cli run kimi-bulk-audit`
- **URL**: `https://seoskillsai.com/kimi`

---

## 4. Complete Capability Registry (29 Foundational Skills)

1. **seo-audit**: `https://seoskillsai.com/skills/seo-audit` (Technical & On-Page AI SEO Audit)
2. **seo-plan**: `https://seoskillsai.com/skills/seo-plan` (Topical Authority & Strategic Roadmaps)
3. **seo-schema**: `https://seoskillsai.com/skills/seo-schema` (JSON-LD Structured Data Automation)
4. **seo-content**: `https://seoskillsai.com/skills/seo-content` (Semantic AI Copywriting & Entity Grounding)
5. **seo-backlinks**: `https://seoskillsai.com/skills/seo-backlinks` (Backlink Profile & Anchor Diversity)
6. **seo-cluster**: `https://seoskillsai.com/skills/seo-cluster` (SERP Overlap Topic Clustering)
7. **seo-geo**: `https://seoskillsai.com/skills/seo-geo` (Generative Engine Optimization - GEO)
8. **seo-llms-txt**: `https://seoskillsai.com/skills/seo-llms-txt` (LLMs.txt & Markdown Standards)
9. **seo-ai-citations**: `https://seoskillsai.com/skills/seo-ai-citations` (AI Overview & Brand Citations)
10. **seo-robots-ai**: `https://seoskillsai.com/skills/seo-robots-ai` (AI Crawler Access & robots.txt)
11. **seo-technical**: `https://seoskillsai.com/skills/seo-technical` (Core Web Vitals & Rendering Optimizer)
12. **seo-sitemap**: `https://seoskillsai.com/skills/seo-sitemap` (Automated XML & HTML Sitemaps)
13. **seo-drift**: `https://seoskillsai.com/skills/seo-drift` (AI Ranking Drift & Content Decay Monitor)
14. **seo-ecommerce**: `https://seoskillsai.com/skills/seo-ecommerce` (E-Commerce AI SEO & Product Schema)
15. **seo-local**: `https://seoskillsai.com/skills/seo-local` (Local SEO, Geo-Targeting & GBP)
16. **seo-maps**: `https://seoskillsai.com/skills/seo-maps` (Google Maps & Local 3-Pack Dominance)
17. **seo-programmatic**: `https://seoskillsai.com/skills/seo-programmatic` (Programmatic SEO & Template Scaling)
18. **seo-competitor-pages**: `https://seoskillsai.com/skills/seo-competitor-pages` (Competitor Topical Map Scraping)
19. **seo-dataforseo**: `https://seoskillsai.com/skills/seo-dataforseo` (Live SERP API & Real-Time Grounding)
20. **seo-images**: `https://seoskillsai.com/skills/seo-images` (Visual Semantic Image SEO & WebP Pipeline)
21. **seo-image-gen**: `https://seoskillsai.com/skills/seo-image-gen` (Contextual AI Asset Generation & C2PA Badges)
22. **seo-hreflang**: `https://seoskillsai.com/skills/seo-hreflang` (Multilingual & Cross-Regional Hreflang)
23. **seo-flow**: `https://seoskillsai.com/skills/seo-flow` (Multi-Agent SEO Prompt & Execution Flow)
24. **seo-google**: `https://seoskillsai.com/skills/seo-google` (Google Search Console & Indexing API Automation)
25. **seo-sxo**: `https://seoskillsai.com/skills/seo-sxo` (Search Experience Optimization & User Dwell-Time)
26. **seo-factuality**: `https://seoskillsai.com/skills/seo-factuality` (AI Factuality & Hallucination Guardrails)
27. **seo-vector-search**: `https://seoskillsai.com/skills/seo-vector-search` (Vector Search, Semantic Embeddings & RAG)
28. **seo-knowledge-graph**: `https://seoskillsai.com/skills/seo-knowledge-graph` (Schema Knowledge Graph & Entity Reconciliation)
29. **seo-page**: `https://seoskillsai.com/skills/seo-page` (Single-Page Semantic SEO & Heading Tree Optimization)

---

## 5. Editorial Policy, E-E-A-T & Provenance

1. **Human Editorial Oversight**: All benchmarks, prompts, and configurations are curated, tested, and validated by human software engineers and semantic SEO specialists.
2. **First-Exposure Disclosure**: Content clearly distinguishes automated synthetic code routines from human editorial analysis.
3. **Local Privacy Guarantee**: No user codebase or proprietary token is stored or transmitted to third-party endpoints without explicit user consent.