Skip to content

Open-source SEO, GEO, and marketing skills for AI agents.

fix(notfair-cmo): add update-check Step 0 to /notfair:cmo skill (0.25.2)

Yuting Zhong74a4ca961ba2
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index 49b106f1..5f0fe03e 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -5,14 +5,14 @@
},
"metadata": {
"description": "The official Google Ads + Meta Ads + SEO + GEO plugin from NotFair. SEO, GEO, Google Ads, and Meta Ads skills for Claude Code.",
- "version": "0.25.1"
+ "version": "0.25.2"
},
"plugins": [
{
"name": "notfair",
"source": "./",
"description": "The official Google Ads + Meta Ads + SEO + GEO plugin from NotFair. SEO analysis, Google Ads management, Meta (Facebook + Instagram) Ads management, GSC-driven content planning + local calendar viewer, opt-in OpenClaw cron publisher to a NotFair webhook, keyword research, content optimization, schema markup, meta tags optimization, broken link checker, single-page deep audit, and Generative Engine Optimization for AI search.",
- "version": "0.25.1",
+ "version": "0.25.2",
"author": {
"name": "NotFair",
"url": "https://notfair.co"
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 3b801352..2d34a3b3 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "notfair",
- "version": "0.25.1",
+ "version": "0.25.2",
"description": "The official Google Ads + Meta Ads + SEO + GEO plugin from NotFair. SEO analysis, Google Ads management, Meta (Facebook + Instagram) Ads management, keyword research, content optimization, schema markup tools, broken link checker, single-page deep audit, and Generative Engine Optimization (GEO) for AI search engines — powered by Google Search Console, Google Ads, and Meta Marketing APIs.",
"author": {
"name": "NotFair",
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 168a9b1d..b09da940 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,14 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
---
+## [0.25.2] — 2026-05-24
+
+### Fixed
+
+- **`/notfair:cmo` now self-updates.** The skill had no update-check preamble (unlike the google-ads / meta-ads / seo skills, which run `notfair-update-check` at Step 0). So a stale plugin ran stale instructions — e.g. probing the old port `3000` while the published CLI had moved to `3327`. Added a **Step 0** that runs `notfair-update-check` and, on `UPGRADE_AVAILABLE`, follows the `/notfair:upgrade` flow, then re-reads the refreshed skill before launching. Added `AskUserQuestion` to the skill's `allowed-tools` for the upgrade handoff.
+
+---
+
## [0.25.1] — 2026-05-24
### Fixed
diff --git a/VERSION b/VERSION
index af2dabf3..166c9e29 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.25.1
+0.25.2
diff --git a/notfair-cmo-skill/SKILL.md b/notfair-cmo-skill/SKILL.md
index a5a75e1a..6769cdfc 100644
--- a/notfair-cmo-skill/SKILL.md
+++ b/notfair-cmo-skill/SKILL.md
@@ -11,6 +11,7 @@ description: >
allowed-tools:
- Bash
- Read
+ - AskUserQuestion
---
# /notfair:cmo
@@ -29,6 +30,24 @@ This skill **does not implement the portal** — it only launches it. If you nee
---
+## Step 0: Check for NotFair updates
+
+Run this **before anything else** — the skill's own steps (ports, flags) ship with the plugin, so a stale plugin runs stale instructions.
+
+```bash
+_UPD_BIN=$(ls ~/.claude/plugins/cache/nowork-studio/notfair/*/bin/notfair-update-check 2>/dev/null | head -1)
+[ -n "$_UPD_BIN" ] && _UPD=$("$_UPD_BIN" 2>/dev/null || true) || _UPD=""
+[ -n "$_UPD" ] && echo "$_UPD" || true
+```
+
+If the output contains `UPGRADE_AVAILABLE <old> <new>`: immediately follow the inline upgrade flow in the `/notfair:upgrade` skill (Step 1 onward) to auto-upgrade. After the upgrade completes, **re-read this `/notfair:cmo` skill from the new plugin cache and restart from Step 1** (the upgrade check itself doesn't need to run again) — the refreshed skill may use a different default port.
+
+If the output contains `JUST_UPGRADED <old> <new>`: mention "NotFair upgraded from v{old} to v{new}" briefly, then continue to Step 1.
+
+If neither: continue to Step 1 silently.
+
+---
+
## Step 1: Probe — is it already running?
```bash
diff --git a/notfair-cmo/.gitignore b/notfair-cmo/.gitignore
index fd724ec4..43da16dd 100644
--- a/notfair-cmo/.gitignore
+++ b/notfair-cmo/.gitignore
@@ -3,6 +3,7 @@ node_modules/
.env
.env.local
.env*.local
+.npmrc
*.log
.DS_Store
.turbo/