Skip to content

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.json
index 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.json
index 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.json
index 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.json
index 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.md
index 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
### Fixed
diff --git a/VERSION b/VERSION
index 69bf493e..c7c49b4b 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.27.5
+0.27.6
diff --git a/gemini-extension.json b/gemini-extension.json
index 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.json
index 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.json
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.md
index 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.py
index 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()