Skip to content

Universal SEO skill for Claude Code. 26 sub-skills + 19 sub-agents covering technical SEO, E-E-A-T, schema, GEO/AEO, agent readiness (Lighthouse Agentic Browsing, WebMCP, llms.txt), backlinks, local SEO, e-commerce, international SEO, Google APIs, and PDF/Excel reporting. 9 optional extensions for live SEO data.

docs: document /seo content-brief, add /seo flow to command table, reconcile counts

Danielebb8d063afce
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 042cb47..5a31f32 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -46,6 +46,7 @@ Security, cross-platform, and data-accuracy release. Folds the v2.1.0 currency c
- Docs normalized from bare `python` to `python3`; CLAUDE.md and AGENTS.md script inventory corrected to 50; README test count updated.
- Corrected the inert `user-invokable` frontmatter key to `user-invocable`.
- Pinned the Ahrefs, Unlighthouse, and DataForSEO npm packages to exact versions across installers and prewarm steps.
+- Documented the `/seo content-brief` command in the command reference and README, added `/seo flow` to the project command table, and reconciled the command count to the 25 the orchestrator routes.
### Housekeeping
diff --git a/CLAUDE.md b/CLAUDE.md
index 2a49295..fa2c57f 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -150,6 +150,7 @@ claude-seo/
| `/seo page <url>` | Deep single-page analysis |
| `/seo technical <url>` | Technical SEO audit (9 categories) |
| `/seo content <url>` | E-E-A-T and content quality analysis |
+| `/seo content-brief <topic>` | Detailed SEO content brief: keywords, outline, internal links |
| `/seo schema <url>` | Schema.org detection, validation, generation |
| `/seo sitemap <url>` | XML sitemap analysis or generation |
| `/seo images <url or optimize>` | Image SEO: on-page audit, SERP analysis, file optimization |
@@ -170,6 +171,7 @@ claude-seo/
| `/seo drift compare <url>` | Compare current state to stored baseline |
| `/seo drift history <url>` | Show drift history over time |
| `/seo ecommerce <url>` | E-commerce SEO: product schema, marketplace intelligence |
+| `/seo flow <url>` | Apply the FLOW framework: stage prompts and structured search-and-conversion output |
| `/seo firecrawl [command] <url>` | Full-site crawling and site mapping (extension) |
| `/seo dataforseo [command]` | Live SEO data via DataForSEO MCP (extension) |
| `/seo image-gen [use-case] <desc>` | AI image generation for SEO assets (extension) |
diff --git a/README.md b/README.md
index cbf94d3..acddb8d 100644
--- a/README.md
+++ b/README.md
@@ -138,7 +138,7 @@ claude
![Claude SEO sub-skill ecosystem: 25 modules grouped into 8 categories (audit, content, schema, technical, AI search, local + maps, commerce + intl, extensions) around the central orchestrator](assets/sub-skills.svg)
-27 user-invocable commands across the orchestrator and 25 sub-skills. Full reference in [docs/COMMANDS.md](docs/COMMANDS.md).
+25 user-invocable `/seo` commands across the orchestrator and its sub-skills. Full reference in [docs/COMMANDS.md](docs/COMMANDS.md).
| Command | Description |
|---------|-------------|
@@ -146,6 +146,7 @@ claude
| `/seo page <url>` | Deep single-page analysis |
| `/seo technical <url>` | Technical SEO audit across 9 categories |
| `/seo content <url>` | E-E-A-T and content quality analysis |
+| `/seo content-brief <topic>` | Detailed content brief: target keywords, outline, internal links |
| `/seo schema <url>` | Detect, validate, and generate Schema.org markup |
| `/seo geo <url>` | AI Overviews / Generative Engine Optimization |
| `/seo sitemap <url \| generate>` | Analyze or generate XML sitemaps |
@@ -421,7 +422,7 @@ Claude SEO is part of a family of Claude Code skills that interoperate cleanly:
## Documentation
- [Installation Guide](docs/INSTALLATION.md)
-- [Commands Reference](docs/COMMANDS.md): 27 commands in depth
+- [Commands Reference](docs/COMMANDS.md): every `/seo` command in depth
- [Architecture](docs/ARCHITECTURE.md): 3-layer design, auto-discovery, parallel dispatch
- [Migration v1 → v2](docs/MIGRATION-v1-to-v2.md): breaking changes, six phases of work
- [MCP Integration](docs/MCP-INTEGRATION.md): extension setup for all 8 servers
diff --git a/docs/COMMANDS.md b/docs/COMMANDS.md
index 70fbb4c..1945285 100644
--- a/docs/COMMANDS.md
+++ b/docs/COMMANDS.md
@@ -89,6 +89,24 @@ E-E-A-T and content quality analysis.
---
+### `/seo content-brief <topic or url>`
+
+Generate a detailed SEO content brief: target keywords, search intent, heading outline, internal link targets, and competitor angle.
+
+**Example:**
+```
+/seo content-brief "best running shoes for flat feet"
+```
+
+**What it produces:**
+- Primary and secondary target keywords
+- Search intent and audience
+- Section-by-section heading outline
+- Internal link recommendations
+- Competitor content angles to beat
+
+---
+
### `/seo schema <url>`
Schema markup detection, validation, and generation.
@@ -539,6 +557,7 @@ Live SEO data via DataForSEO MCP server (extension). 22 commands across 9 API mo
| `/seo page <url>` | Single page analysis |
| `/seo technical <url>` | Technical SEO across 9 categories |
| `/seo content <url>` | E-E-A-T and content quality |
+| `/seo content-brief <topic>` | Detailed content brief: keywords, outline, internal links |
| `/seo schema <url>` | Schema markup detection, validation, generation |
| `/seo sitemap <url>` | Sitemap validation |
| `/seo sitemap generate` | Create new sitemap with industry templates |