diff --git a/skills/bmad-cis-agent-brainstorming-coach/SKILL.md b/skills/bmad-cis-agent-brainstorming-coach/SKILL.md
index ec4d56f..5624117 100644
--- a/skills/bmad-cis-agent-brainstorming-coach/SKILL.md
+++ b/skills/bmad-cis-agent-brainstorming-coach/SKILL.md
@@ -13,7 +13,7 @@ You are Carson, the Elite Brainstorming Specialist. You facilitate breakthrough
 
 - Bare paths (e.g. `references/guide.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
diff --git a/skills/bmad-cis-agent-creative-problem-solver/SKILL.md b/skills/bmad-cis-agent-creative-problem-solver/SKILL.md
index e2de16b..8823844 100644
--- a/skills/bmad-cis-agent-creative-problem-solver/SKILL.md
+++ b/skills/bmad-cis-agent-creative-problem-solver/SKILL.md
@@ -13,7 +13,7 @@ You are Dr. Quinn, the Master Problem Solver. You crack complex challenges with
 
 - Bare paths (e.g. `references/guide.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
diff --git a/skills/bmad-cis-agent-design-thinking-coach/SKILL.md b/skills/bmad-cis-agent-design-thinking-coach/SKILL.md
index c0219ef..941e17d 100644
--- a/skills/bmad-cis-agent-design-thinking-coach/SKILL.md
+++ b/skills/bmad-cis-agent-design-thinking-coach/SKILL.md
@@ -13,7 +13,7 @@ You are Maya, the Design Thinking Maestro. You guide human-centered design proce
 
 - Bare paths (e.g. `references/guide.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
diff --git a/skills/bmad-cis-agent-innovation-strategist/SKILL.md b/skills/bmad-cis-agent-innovation-strategist/SKILL.md
index 20f79b6..48e7705 100644
--- a/skills/bmad-cis-agent-innovation-strategist/SKILL.md
+++ b/skills/bmad-cis-agent-innovation-strategist/SKILL.md
@@ -13,7 +13,7 @@ You are Victor, the Disruptive Innovation Oracle. You identify disruption opport
 
 - Bare paths (e.g. `references/guide.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
diff --git a/skills/bmad-cis-agent-presentation-master/SKILL.md b/skills/bmad-cis-agent-presentation-master/SKILL.md
index 8230b0f..eb6ca7c 100644
--- a/skills/bmad-cis-agent-presentation-master/SKILL.md
+++ b/skills/bmad-cis-agent-presentation-master/SKILL.md
@@ -13,7 +13,7 @@ You are Caravaggio, the Visual Communication and Presentation Expert. You design
 
 - Bare paths (e.g. `references/guide.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
diff --git a/skills/bmad-cis-agent-storyteller/SKILL.md b/skills/bmad-cis-agent-storyteller/SKILL.md
index 0796f3e..46808fd 100644
--- a/skills/bmad-cis-agent-storyteller/SKILL.md
+++ b/skills/bmad-cis-agent-storyteller/SKILL.md
@@ -13,7 +13,7 @@ You are Sophia, the Master Storyteller. You craft compelling narratives using pr
 
 - Bare paths (e.g. `references/guide.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
diff --git a/skills/bmad-cis-design-thinking/SKILL.md b/skills/bmad-cis-design-thinking/SKILL.md
index 7bf5182..2eeb5b8 100644
--- a/skills/bmad-cis-design-thinking/SKILL.md
+++ b/skills/bmad-cis-design-thinking/SKILL.md
@@ -13,7 +13,7 @@ description: 'Guide human-centered design processes using empathy-driven methodo
 
 - Bare paths (e.g. `template.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
diff --git a/skills/bmad-cis-innovation-strategy/SKILL.md b/skills/bmad-cis-innovation-strategy/SKILL.md
index 73a3839..ae17680 100644
--- a/skills/bmad-cis-innovation-strategy/SKILL.md
+++ b/skills/bmad-cis-innovation-strategy/SKILL.md
@@ -13,7 +13,7 @@ description: 'Identify disruption opportunities and architect business model inn
 
 - Bare paths (e.g. `template.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
diff --git a/skills/bmad-cis-problem-solving/SKILL.md b/skills/bmad-cis-problem-solving/SKILL.md
index 67e53d1..cc2e925 100644
--- a/skills/bmad-cis-problem-solving/SKILL.md
+++ b/skills/bmad-cis-problem-solving/SKILL.md
@@ -13,7 +13,7 @@ description: 'Apply systematic problem-solving methodologies to complex challeng
 
 - Bare paths (e.g. `template.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation
diff --git a/skills/bmad-cis-storytelling/SKILL.md b/skills/bmad-cis-storytelling/SKILL.md
index 4a23619..fa493c0 100644
--- a/skills/bmad-cis-storytelling/SKILL.md
+++ b/skills/bmad-cis-storytelling/SKILL.md
@@ -13,7 +13,7 @@ description: 'Craft compelling narratives using story frameworks. Use when the u
 
 - Bare paths (e.g. `template.md`) resolve from the skill root.
 - `{skill-root}` resolves to this skill's installed directory (where `customize.toml` lives).
-- `{project-root}`-prefixed paths resolve from the project working directory.
+- `{project-root}` is the nearest folder containing `_bmad/`, starting at the project working directory and moving up through its parents.
 - `{skill-name}` resolves to the skill directory's basename.
 
 ## On Activation