All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Extension system:
extensions/directory convention for self-contained add-ons with install/uninstall scripts - DataForSEO extension: 22 commands across 9 API modules (SERP, keywords, backlinks, on-page, content, business listings, AI visibility, LLM mentions). Install:
./extensions/dataforseo/install.sh - DataForSEO integration: seo-audit, seo-content, seo-geo, seo-page, seo-plan, seo-technical auto-detect DataForSEO MCP tools for enriched analysis
- Plugin manifest:
.claude-plugin/plugin.jsonfor official plugin directory submission - Documentation: Extensions architecture in ARCHITECTURE.md, 22 new commands in COMMANDS.md, updated MCP integration guide
- Title tag threshold: Pre-commit hook now uses 60-char max, aligned with quality-gates.md and echo message
- SSRF prevention: Added to
capture_screenshot.py(defense-in-depth, matchingfetch_page.py) - Frontmatter cleanup: Removed non-standard
allowed-toolsfrom main SKILL.md
- Sub-skill count: 12 + 1 extension (added seo-dataforseo via DataForSEO extension)
- Subagent count: 6 + 1 optional (added seo-dataforseo agent via extension)
- DataForSEO promoted from "Community" to "Official extension" in MCP docs
- SSRF prevention: Added private IP blocking to
fetch_page.pyandanalyze_visual.py - Path traversal prevention: Added output path sanitization to
capture_screenshot.pyand file validation toparse_html.py - Install hardening: Removed
--break-system-packages, switched to venv-based pip install - requirements.txt: Now persisted to
~/.claude/skills/seo/for user retry
- YAML frontmatter parsing: Removed HTML comments before
---delimiter in 8 files (skills: seo-content, seo-images, seo-programmatic, seo-schema, seo-technical; agents: seo-content, seo-performance, seo-technical). Thanks @kylewhirl for identifying this in the codex-seo fork. - Windows installer: Merged @kfrancis improvements —
python -m pip,py -3launcher fallback, requirements.txt persistence, non-fatal subagent copy, better error diagnostics (PR #6) - requirements.txt missing after install: Now copied to skill directory so users can retry (#1)
- Python dependencies now installed in a venv at
~/.claude/skills/seo/.venv/with--userfallback (#2) - Playwright marked as explicitly optional in install output
- Windows installer uses
Resolve-Pythonhelper for robust Python detection (#5)
- urllib3 ≥2.6.3: Fixes CVE-2026-21441 (CVSS 8.9) - decompression bypass vulnerability
- lxml ≥6.0.2: Updated from 5.3.2 for additional libxml2 security patches
- Pillow ≥12.1.0: Fixes CVE-2025-48379
- playwright ≥1.55.1: Fixes CVE-2025-59288 (macOS)
- requests ≥2.32.4: Fixes CVE-2024-47081, CVE-2024-35195
- GEO (Generative Engine Optimization) major enhancement:
- Brand mention analysis (3× more important than backlinks for AI visibility)
- AI crawler detection (GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot, etc.)
- llms.txt standard detection and recommendations
- RSL 1.0 (Really Simple Licensing) detection
- Passage-level citability scoring (optimal 134-167 words)
- Platform-specific optimization (Google AI Overviews vs ChatGPT vs Perplexity)
- Server-side rendering checks for AI crawler accessibility
- LCP Subparts analysis: TTFB, resource load delay, resource load time, render delay
- Soft Navigations API detection for SPA CWV measurement limitations
- Schema.org v29.4 additions: ConferenceEvent, PerformingArtsEvent, LoyaltyProgram
- E-commerce schema updates: returnPolicyCountry now required, organization-level policies
- E-E-A-T framework: Updated for December 2025 core update - now applies to ALL competitive queries, not just YMYL
- SKILL.md description: Expanded to leverage new 1024-character limit
- Schema deprecations expanded: Added ClaimReview, VehicleListing (June 2025)
- WebApplication schema: Added as correct type for browser-based SaaS (vs SoftwareApplication)
- Schema-types.md now correctly distinguishes SoftwareApplication (apps) vs WebApplication (SaaS)
- Initial release of Claude SEO
- 9 specialized skills: audit, page, sitemap, schema, images, technical, content, geo, plan
- 6 subagents for parallel analysis: seo-technical, seo-content, seo-schema, seo-sitemap, seo-performance, seo-visual
- Industry templates: SaaS, local service, e-commerce, publisher, agency, generic
- Schema library with deprecation tracking:
- HowTo schema marked deprecated (September 2023)
- FAQ schema restricted to government/healthcare sites only (August 2023)
- SpecialAnnouncement schema marked deprecated (July 31, 2025)
- AI Overviews / GEO optimization skill (seo-geo) - new for 2026
- Core Web Vitals analysis using current metrics:
- LCP (Largest Contentful Paint): <2.5s
- INP (Interaction to Next Paint): <200ms - replaced FID on March 12, 2024
- CLS (Cumulative Layout Shift): <0.1
- E-E-A-T framework updated to September 2025 Quality Rater Guidelines
- Quality gates for thin content and doorway page prevention:
- Warning at 30+ location pages
- Hard stop at 50+ location pages
- Pre-commit and post-edit automation hooks
- One-command install and uninstall scripts (Unix and Windows)
- Bounded Python dependency pinning with CVE-aware minimums (lxml >= 5.3.2)
- Follows Anthropic's official Claude Code skill specification (February 2026)
- Standard directory layout:
scripts/,references/,assets/ - Valid hook matchers (tool name only, no argument patterns)
- Correct subagent frontmatter fields (name, description, tools)
- CLI command is
claude(notclaude-code)