Open-source SEO, GEO, and marketing skills for AI agents.
fix: resolve Codex ads skills from plugin root (#118)
Tong Chen9d80428658ba
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex 6d0f6e5f..1e404416 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -5,14 +5,14 @@},"metadata": {"description": "The official ads, analytics, SEO, and GEO plugin from NotFair.",- "version": "0.27.5"+ "version": "0.27.6"},"plugins": [{"name": "notfair","source": "./","description": "Operate Google, Meta, X, and LinkedIn Ads; analyze Search Console and GA4; and run open-source SEO, GEO, and content workflows.",- "version": "0.27.5",+ "version": "0.27.6","author": {"name": "NotFair","url": "https://notfair.co"diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex bbbe5913..76617a3d 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "notfair",- "version": "0.27.5",+ "version": "0.27.6","description": "The official ads, analytics, SEO, and GEO plugin from NotFair. Operate Google, Meta, X, and LinkedIn Ads; analyze Google Search Console and GA4; and run open-source search and content workflows from any compatible agent.","author": {"name": "NotFair",diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.jsonindex 4a0ba5da..7f2148e3 100644--- a/.codex-plugin/plugin.json+++ b/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "notfair",- "version": "0.27.5",+ "version": "0.27.6","description": "The official ads, analytics, SEO, and GEO plugin from NotFair.","author": {"name": "NotFair",diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.jsonindex 206794cf..c56b52bd 100644--- a/.cursor-plugin/plugin.json+++ b/.cursor-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "notfair","displayName": "NotFair",- "version": "0.27.5",+ "version": "0.27.6","description": "Operate Google, Meta, X and LinkedIn Ads, analyze GA4 and Search Console, and run SEO, GEO and content workflows with one NotFair OAuth MCP connection.","author": {"name": "Notfair",diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 6a7388b5..eca05283 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -9,6 +9,12 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).## [Unreleased]+## [0.27.6] — 2026-09-09++### Fixed++- Codex ads-skill wrappers now resolve canonical workflows explicitly from the installed plugin root and fail closed instead of falling back to a similarly named skill from another plugin.+## [0.27.5] — 2026-09-05### Fixeddiff --git a/VERSION b/VERSIONindex 69bf493e..c7c49b4b 100644--- a/VERSION+++ b/VERSION@@ -1 +1 @@-0.27.5+0.27.6diff --git a/gemini-extension.json b/gemini-extension.jsonindex 02fa5ff6..a49b3c8b 100644--- a/gemini-extension.json+++ b/gemini-extension.json@@ -1,6 +1,6 @@{"name": "notfair",- "version": "0.27.5",+ "version": "0.27.6","description": "Operate ads and analytics, and run open-source SEO, GEO, and content workflows with NotFair.","contextFileName": "AGENTS.md","mcpServers": {diff --git a/plugin.json b/plugin.jsonindex f7b3dfc2..30562fbe 100644--- a/plugin.json+++ b/plugin.json@@ -1,7 +1,7 @@{"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json","name": "notfair",- "version": "0.27.5",+ "version": "0.27.6","description": "Operate ads and analytics, and run open-source SEO, GEO, and content workflows from compatible AI agents.","author": {"name": "NotFair",diff --git a/server.json b/server.jsonindex 17a4dc03..0298a3a7 100644--- a/server.json+++ b/server.json@@ -8,7 +8,7 @@"url": "https://github.com/nowork-studio/notfair-plugin","source": "github"},- "version": "0.27.5",+ "version": "0.27.6","remotes": [{"type": "streamable-http",diff --git a/skills/google-ads-assets/SKILL.md b/skills/google-ads-assets/SKILL.mdindex 490277dc..bd978db5 100644--- a/skills/google-ads-assets/SKILL.md+++ b/skills/google-ads-assets/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<campaign, asset group, or 'build an asset brief'>"# Canonical NotFair workflow-Read [`../../google-ads/assets/SKILL.md`](../../google-ads/assets/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../google-ads/assets/`.+Read [`../../google-ads/assets/SKILL.md`](../../google-ads/assets/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/google-ads/assets/SKILL.md`, not `<plugin-root>/skills/google-ads-assets/assets/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/google-ads/assets/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/google-ads-audit/SKILL.md b/skills/google-ads-audit/SKILL.mdindex 14820f5c..43f8ec02 100644--- a/skills/google-ads-audit/SKILL.md+++ b/skills/google-ads-audit/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<account name or 'audit my ads'>"# Canonical NotFair workflow-Read [`../../google-ads/audit/SKILL.md`](../../google-ads/audit/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../google-ads/audit/`.+Read [`../../google-ads/audit/SKILL.md`](../../google-ads/audit/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/google-ads/audit/SKILL.md`, not `<plugin-root>/skills/google-ads-audit/audit/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/google-ads/audit/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/google-ads-copy/SKILL.md b/skills/google-ads-copy/SKILL.mdindex fc38fded..a6ce268f 100644--- a/skills/google-ads-copy/SKILL.md+++ b/skills/google-ads-copy/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<ad group name, keyword theme, or 'write new ads'>"# Canonical NotFair workflow-Read [`../../google-ads/copy/SKILL.md`](../../google-ads/copy/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../google-ads/copy/`.+Read [`../../google-ads/copy/SKILL.md`](../../google-ads/copy/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/google-ads/copy/SKILL.md`, not `<plugin-root>/skills/google-ads-copy/copy/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/google-ads/copy/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/google-ads-landing/SKILL.md b/skills/google-ads-landing/SKILL.mdindex 79ff87ac..e857f204 100644--- a/skills/google-ads-landing/SKILL.md+++ b/skills/google-ads-landing/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<landing page URL or ad group name>"# Canonical NotFair workflow-Read [`../../google-ads/landing/SKILL.md`](../../google-ads/landing/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../google-ads/landing/`.+Read [`../../google-ads/landing/SKILL.md`](../../google-ads/landing/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/google-ads/landing/SKILL.md`, not `<plugin-root>/skills/google-ads-landing/landing/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/google-ads/landing/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/google-ads/SKILL.md b/skills/google-ads/SKILL.mdindex a068351d..1504df18 100644--- a/skills/google-ads/SKILL.md+++ b/skills/google-ads/SKILL.md@@ -37,4 +37,4 @@ triggers:# Canonical NotFair workflow-Read [`../../google-ads/manage/SKILL.md`](../../google-ads/manage/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../google-ads/manage/`.+Read [`../../google-ads/manage/SKILL.md`](../../google-ads/manage/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/google-ads/manage/SKILL.md`, not `<plugin-root>/skills/google-ads/manage/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/google-ads/manage/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/meta-ads-audit/SKILL.md b/skills/meta-ads-audit/SKILL.mdindex 123948b2..fbcd9eff 100644--- a/skills/meta-ads-audit/SKILL.md+++ b/skills/meta-ads-audit/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<account name or 'audit my Meta ads'>"# Canonical NotFair workflow-Read [`../../meta-ads/audit/SKILL.md`](../../meta-ads/audit/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../meta-ads/audit/`.+Read [`../../meta-ads/audit/SKILL.md`](../../meta-ads/audit/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/meta-ads/audit/SKILL.md`, not `<plugin-root>/skills/meta-ads-audit/audit/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/meta-ads/audit/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/meta-ads-creative/SKILL.md b/skills/meta-ads-creative/SKILL.mdindex 851620b5..3853476e 100644--- a/skills/meta-ads-creative/SKILL.md+++ b/skills/meta-ads-creative/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<campaign, audience, or 'build a creative slate'>"# Canonical NotFair workflow-Read [`../../meta-ads/creative/SKILL.md`](../../meta-ads/creative/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../meta-ads/creative/`.+Read [`../../meta-ads/creative/SKILL.md`](../../meta-ads/creative/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/meta-ads/creative/SKILL.md`, not `<plugin-root>/skills/meta-ads-creative/creative/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/meta-ads/creative/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/meta-ads/SKILL.md b/skills/meta-ads/SKILL.mdindex f8c43178..9f4d5c55 100644--- a/skills/meta-ads/SKILL.md+++ b/skills/meta-ads/SKILL.md@@ -29,4 +29,4 @@ triggers:# Canonical NotFair workflow-Read [`../../meta-ads/manage/SKILL.md`](../../meta-ads/manage/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../meta-ads/manage/`.+Read [`../../meta-ads/manage/SKILL.md`](../../meta-ads/manage/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/meta-ads/manage/SKILL.md`, not `<plugin-root>/skills/meta-ads/manage/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/meta-ads/manage/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-amazon/SKILL.md b/skills/paid-ads-amazon/SKILL.mdindex e46b7d76..14fb75ee 100644--- a/skills/paid-ads-amazon/SKILL.md+++ b/skills/paid-ads-amazon/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<ASIN, product line, target ACoS, or Amazon export>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-amazon/SKILL.md`](../../paid-ads/paid-ads-amazon/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-amazon/`.+Read [`../../paid-ads/paid-ads-amazon/SKILL.md`](../../paid-ads/paid-ads-amazon/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-amazon/SKILL.md`, not `<plugin-root>/skills/paid-ads-amazon/paid-ads-amazon/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-amazon/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-chatgpt/SKILL.md b/skills/paid-ads-chatgpt/SKILL.mdindex 852a5036..2c17e709 100644--- a/skills/paid-ads-chatgpt/SKILL.md+++ b/skills/paid-ads-chatgpt/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<objective, audience, or verified ChatGPT Ads export>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-chatgpt/SKILL.md`](../../paid-ads/paid-ads-chatgpt/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-chatgpt/`.+Read [`../../paid-ads/paid-ads-chatgpt/SKILL.md`](../../paid-ads/paid-ads-chatgpt/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-chatgpt/SKILL.md`, not `<plugin-root>/skills/paid-ads-chatgpt/paid-ads-chatgpt/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-chatgpt/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-creative/SKILL.md b/skills/paid-ads-creative/SKILL.mdindex 40b4fa09..15b3bfde 100644--- a/skills/paid-ads-creative/SKILL.md+++ b/skills/paid-ads-creative/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<platform, audience, or campaign>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-creative/SKILL.md`](../../paid-ads/paid-ads-creative/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-creative/`.+Read [`../../paid-ads/paid-ads-creative/SKILL.md`](../../paid-ads/paid-ads-creative/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-creative/SKILL.md`, not `<plugin-root>/skills/paid-ads-creative/paid-ads-creative/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-creative/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-guide/SKILL.md b/skills/paid-ads-guide/SKILL.mdindex b0759a5d..48adc287 100644--- a/skills/paid-ads-guide/SKILL.md+++ b/skills/paid-ads-guide/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<installation, capability, connection, or product question>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-guide/SKILL.md`](../../paid-ads/paid-ads-guide/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-guide/`.+Read [`../../paid-ads/paid-ads-guide/SKILL.md`](../../paid-ads/paid-ads-guide/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-guide/SKILL.md`, not `<plugin-root>/skills/paid-ads-guide/paid-ads-guide/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-guide/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-integrations/SKILL.md b/skills/paid-ads-integrations/SKILL.mdindex ba3894c4..76e5ec61 100644--- a/skills/paid-ads-integrations/SKILL.md+++ b/skills/paid-ads-integrations/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<platform or connection issue>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-integrations/SKILL.md`](../../paid-ads/paid-ads-integrations/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-integrations/`.+Read [`../../paid-ads/paid-ads-integrations/SKILL.md`](../../paid-ads/paid-ads-integrations/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-integrations/SKILL.md`, not `<plugin-root>/skills/paid-ads-integrations/paid-ads-integrations/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-integrations/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-launch/SKILL.md b/skills/paid-ads-launch/SKILL.mdindex cf276b67..d0081d2b 100644--- a/skills/paid-ads-launch/SKILL.md+++ b/skills/paid-ads-launch/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<business goal, budget, and target platform>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-launch/SKILL.md`](../../paid-ads/paid-ads-launch/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-launch/`.+Read [`../../paid-ads/paid-ads-launch/SKILL.md`](../../paid-ads/paid-ads-launch/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-launch/SKILL.md`, not `<plugin-root>/skills/paid-ads-launch/paid-ads-launch/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-launch/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-linkedin/SKILL.md b/skills/paid-ads-linkedin/SKILL.mdindex 2a2255ac..9e6e830a 100644--- a/skills/paid-ads-linkedin/SKILL.md+++ b/skills/paid-ads-linkedin/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<B2B goal, audience, account, or date range>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-linkedin/SKILL.md`](../../paid-ads/paid-ads-linkedin/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-linkedin/`.+Read [`../../paid-ads/paid-ads-linkedin/SKILL.md`](../../paid-ads/paid-ads-linkedin/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-linkedin/SKILL.md`, not `<plugin-root>/skills/paid-ads-linkedin/paid-ads-linkedin/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-linkedin/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-optimize/SKILL.md b/skills/paid-ads-optimize/SKILL.mdindex c1206bc2..ab2ea7fd 100644--- a/skills/paid-ads-optimize/SKILL.md+++ b/skills/paid-ads-optimize/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<campaign, target CPA/ROAS, or 'find waste'>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-optimize/SKILL.md`](../../paid-ads/paid-ads-optimize/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-optimize/`.+Read [`../../paid-ads/paid-ads-optimize/SKILL.md`](../../paid-ads/paid-ads-optimize/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-optimize/SKILL.md`, not `<plugin-root>/skills/paid-ads-optimize/paid-ads-optimize/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-optimize/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-review/SKILL.md b/skills/paid-ads-review/SKILL.mdindex 68de7988..ab7e7c8e 100644--- a/skills/paid-ads-review/SKILL.md+++ b/skills/paid-ads-review/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<date range, platform, or 'weekly review'>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-review/SKILL.md`](../../paid-ads/paid-ads-review/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-review/`.+Read [`../../paid-ads/paid-ads-review/SKILL.md`](../../paid-ads/paid-ads-review/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-review/SKILL.md`, not `<plugin-root>/skills/paid-ads-review/paid-ads-review/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-review/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-setup/SKILL.md b/skills/paid-ads-setup/SKILL.mdindex 434cbf94..3330bcc1 100644--- a/skills/paid-ads-setup/SKILL.md+++ b/skills/paid-ads-setup/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<connect accounts, workspace, or brand>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-setup/SKILL.md`](../../paid-ads/paid-ads-setup/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-setup/`.+Read [`../../paid-ads/paid-ads-setup/SKILL.md`](../../paid-ads/paid-ads-setup/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-setup/SKILL.md`, not `<plugin-root>/skills/paid-ads-setup/paid-ads-setup/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-setup/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-tiktok/SKILL.md b/skills/paid-ads-tiktok/SKILL.mdindex 6a049a4e..42987285 100644--- a/skills/paid-ads-tiktok/SKILL.md+++ b/skills/paid-ads-tiktok/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<goal, product, creator asset, or TikTok export>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-tiktok/SKILL.md`](../../paid-ads/paid-ads-tiktok/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-tiktok/`.+Read [`../../paid-ads/paid-ads-tiktok/SKILL.md`](../../paid-ads/paid-ads-tiktok/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-tiktok/SKILL.md`, not `<plugin-root>/skills/paid-ads-tiktok/paid-ads-tiktok/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-tiktok/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads-x/SKILL.md b/skills/paid-ads-x/SKILL.mdindex 03e39226..513cdd02 100644--- a/skills/paid-ads-x/SKILL.md+++ b/skills/paid-ads-x/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<account, campaign, date range, or X Ads goal>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads-x/SKILL.md`](../../paid-ads/paid-ads-x/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads-x/`.+Read [`../../paid-ads/paid-ads-x/SKILL.md`](../../paid-ads/paid-ads-x/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads-x/SKILL.md`, not `<plugin-root>/skills/paid-ads-x/paid-ads-x/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads-x/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/skills/paid-ads/SKILL.md b/skills/paid-ads/SKILL.mdindex 0e38d48d..2c3b5cfd 100644--- a/skills/paid-ads/SKILL.md+++ b/skills/paid-ads/SKILL.md@@ -6,4 +6,4 @@ argument-hint: "<goal, platform, or 'review my ads'>"# Canonical NotFair workflow-Read [`../../paid-ads/paid-ads/SKILL.md`](../../paid-ads/paid-ads/SKILL.md) completely, then follow it as the active workflow. Resolve every relative reference from that file against `../../paid-ads/paid-ads/`.+Read [`../../paid-ads/paid-ads/SKILL.md`](../../paid-ads/paid-ads/SKILL.md) completely, then follow it as the active workflow. Normalize that path from the directory containing this wrapper: the canonical file is `<plugin-root>/paid-ads/paid-ads/SKILL.md`, not `<plugin-root>/skills/paid-ads/paid-ads/SKILL.md`. Resolve every relative reference from the canonical file against `<plugin-root>/paid-ads/paid-ads/`. If the canonical file cannot be read, stop and report the packaging error; never substitute a similarly named skill from another plugin.diff --git a/test/test_mcp_skill_e2e.py b/test/test_mcp_skill_e2e.pyindex 96151f3c..446b39d1 100644--- a/test/test_mcp_skill_e2e.py+++ b/test/test_mcp_skill_e2e.py@@ -65,6 +65,29 @@ def test_universal_mcp_is_the_only_registered_server_and_skills_are_portable():assert f"./{skill}" in plugin["skills"]+def test_ads_wrappers_resolve_from_the_plugin_root_without_fallback():+ plugin = json.loads((ROOT / ".claude-plugin/plugin.json").read_text())+ ads_skill_roots = ("./paid-ads/", "./google-ads/", "./meta-ads/")+ canonical_paths = [+ ROOT / skill.removeprefix("./") / "SKILL.md"+ for skill in plugin["skills"]+ if skill.startswith(ads_skill_roots)+ ]++ for canonical in canonical_paths:+ canonical_text = canonical.read_text()+ skill_name = re.search(r"^name:\s*(.+)$", canonical_text, re.MULTILINE)+ assert skill_name, canonical+ wrapper = ROOT / "skills" / skill_name.group(1).strip() / "SKILL.md"+ wrapper_text = wrapper.read_text()+ relative_target = re.search(r"\]\((\.\./\.\./[^)]+/SKILL\.md)\)", wrapper_text)++ assert relative_target, skill_name+ assert (wrapper.parent / relative_target.group(1)).resolve() == canonical.resolve()+ assert "not `<plugin-root>/skills/" in wrapper_text+ assert "never substitute a similarly named skill from another plugin" in wrapper_text++def test_all_host_configs_and_registry_use_one_versioned_connection():expected = {UNIVERSAL_SERVER: {"type": "http", "url": UNIVERSAL_ENDPOINT}}version = (ROOT / "VERSION").read_text().strip()