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(readme): public-first install + document public-branding divergence

Daniel18459c3cd01c
diff --git a/README.md b/README.md
index 26dbed0..d8b442a 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@
> **Two versions of this skill.**
> - 🌐 **Public open-source** → [`AgriciDaniel/claude-seo`](https://github.com/AgriciDaniel/claude-seo): MIT, public releases, no membership. Use this if you want stable + downloadable.
-> - 🔒 **Community private mirror** (this repo) → [`AI-Marketing-Hub/claude-seo`](https://github.com/AI-Marketing-Hub/claude-seo): early access to upcoming features and direct collaboration with the [AI Marketing Hub Pro](https://www.skool.com/ai-marketing-hub-pro) community. Requires membership.
+> - 🔒 **Community private mirror** → [`AI-Marketing-Hub/claude-seo`](https://github.com/AI-Marketing-Hub/claude-seo): early access to upcoming features and direct collaboration with the [AI Marketing Hub Pro](https://www.skool.com/ai-marketing-hub-pro) community. Requires membership.
### Why Claude SEO
@@ -66,16 +66,16 @@ Run a full audit and watch parallel agents fan out across the site:
> ℹ️ **Which version are you installing?**
>
-> - **Not an AI Marketing Hub Pro member?** Install from the public repo → [`AgriciDaniel/claude-seo`](https://github.com/AgriciDaniel/claude-seo). All commands below work there: swap `AI-Marketing-Hub/claude-seo` for `AgriciDaniel/claude-seo` and the plugin slug `claude-seo@ai-marketing-hub-claude-seo` for `claude-seo@agricidaniel-seo`.
-> - **Pro member?** The commands below install the community version with early access. Requires `gh auth login` (or PAT) with access to the `AI-Marketing-Hub` org. If `/plugin marketplace add` 404s, DM in the [Skool community](https://www.skool.com/ai-marketing-hub-pro) to get added.
+> - **Public open-source (default).** The commands below install from [`AgriciDaniel/claude-seo`](https://github.com/AgriciDaniel/claude-seo) — MIT, public releases, no membership required.
+> - **AI Marketing Hub Pro member?** Install the community version with early access instead: swap `AgriciDaniel/claude-seo` for `AI-Marketing-Hub/claude-seo` and the plugin slug `claude-seo@agricidaniel-claude-seo` for `claude-seo@ai-marketing-hub-claude-seo`. Requires `gh auth login` (or PAT) with access to the `AI-Marketing-Hub` org. If `/plugin marketplace add` 404s, DM in the [Skool community](https://www.skool.com/ai-marketing-hub-pro) to get added.
### Plugin Install (Claude Code 1.0.33+)
The fastest path. One-time marketplace add, then plugin install:
```bash
-/plugin marketplace add AI-Marketing-Hub/claude-seo
-/plugin install claude-seo@ai-marketing-hub-claude-seo
+/plugin marketplace add AgriciDaniel/claude-seo
+/plugin install claude-seo@agricidaniel-claude-seo
```
### Manual Install (Unix / macOS / Linux)
diff --git a/docs/WORKFLOW-public-private.md b/docs/WORKFLOW-public-private.md
index 6bd52dd..fcefa62 100644
--- a/docs/WORKFLOW-public-private.md
+++ b/docs/WORKFLOW-public-private.md
@@ -84,7 +84,9 @@ When `v2` (or whatever branch holds the next release) is ready to go public:
# Confirm both remotes are wired up
git remote -v
-# Confirm both remotes see the same main HEAD (should match after a release)
+# Confirm both remotes' main heads.
+# NOTE: origin/main is aimh/main PLUS one public-branding commit (see below),
+# so the SHAs intentionally differ by exactly that commit. Do NOT force-sync them.
git ls-remote --heads aimh main
git ls-remote --heads origin main
@@ -97,6 +99,35 @@ git fetch aimh
git log --oneline aimh/main..aimh/v2
```
+## Public-branding divergence (the one intentional difference)
+
+Since v2.0.0 the two repos are **not** byte-identical. They differ by exactly
+one file on one commit:
+
+| File | `aimh` (private) | `origin` (public) |
+|---|---|---|
+| `.claude-plugin/marketplace.json` `name` | `ai-marketing-hub-claude-seo` | `agricidaniel-claude-seo` |
+| `.claude-plugin/marketplace.json` `owner.name` | `AI Marketing Hub` | `AgriciDaniel` |
+
+Everything else (including `README.md`) is shared and public-first: the
+install block defaults to `AgriciDaniel/claude-seo`, with a Pro swap-note that
+names the private slug. This keeps the public repo free of `ai-marketing-hub`
+slugs while keeping the README a single shared file.
+
+**How the divergence is maintained.** The public-only branding lives as the
+tip commit of `origin/main`, carried on a local `public-main` branch:
+
+```bash
+# public-main = main + one commit that rebrands marketplace.json
+git checkout main && git merge --ff-only v2 # shared canonical
+git checkout public-main && git rebase main # replay branding onto new base
+git push origin public-main:main # public gets canonical + branding
+git push aimh main # private gets canonical only
+```
+
+So `origin/main` = `aimh/main` + 1 commit, by design. The release tag points at
+each repo's own HEAD (`origin` tag includes branding; `aimh` tag does not).
+
## Why two repos?
- The **public** repo is the user-facing artifact. Everything visible
@@ -119,16 +150,14 @@ upgrade.
| Letting `aimh/main` lag behind `origin/main` | Always push to `aimh` first, then `origin` on release |
| Confusing `aimh/v2` with `origin/v2` | `origin` should never have an unreleased `v2` branch |
-## State at the time of writing (2026-05-18)
-
-- `aimh/main` = `7676024` (v1.9.9 final)
-- `origin/main` = `7676024` (v1.9.9 final) ← synced
-- `aimh/v2` = `6778786` (v2.0.0 + Phase J/K/audit cleanup)
-- `origin` has no `v2` branch and no `v2.0.0` tag — both are pre-release
-- `v2.0.0` tag lives on `aimh` only
+## State at the time of writing (2026-05-25)
-This is the expected pre-release shape: private leads, public stays at
-the last released version.
+- v2.0.0 is **released to public**. Latest tag on both remotes: `v2.0.0`.
+- `aimh/main` = shared canonical (public-first README, private marketplace name).
+- `origin/main` = `aimh/main` + the public-branding commit (public marketplace name).
+- `v2.0.0` tag points at each repo's own HEAD: `origin`'s tag includes the
+ branding commit, `aimh`'s does not (see "Public-branding divergence" above).
+- `aimh/v2` tracks the shared canonical for ongoing v2.x work.
## Email-privacy caveat (one-time)