style(skills): follow agentskills.io script conventions

bmadcode · bmadcode · commit 94c29acf3059 · 2026-04-14T12:52:06.000-05:00
- Drop ./ prefix from script paths (use scripts/ not ./scripts/)
- Use python3 instead of python for explicitness
- Add Available Scripts listing to all SKILL.md files
diff --git a/src/skills/bmad-cis-agent-brainstorming-coach/SKILL.md b/src/skills/bmad-cis-agent-brainstorming-coach/SKILL.md
@@ -5,10 +5,14 @@ description: Elite brainstorming specialist for facilitated ideation sessions. U
 
 ## On Activation
 
+### Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ### Step 1: Resolve Activation Customization
 
 Resolve `persona`, `inject`, `additional_resources`, and `menu` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-agent-brainstorming-coach --key persona --key inject --key additional_resources --key menu`
+Run: `python3 scripts/resolve-customization.py bmad-cis-agent-brainstorming-coach --key persona --key inject --key additional_resources --key menu`
 Use the JSON output as resolved values.
 
 ### Step 2: Apply Customization
diff --git a/src/skills/bmad-cis-agent-creative-problem-solver/SKILL.md b/src/skills/bmad-cis-agent-creative-problem-solver/SKILL.md
@@ -5,10 +5,14 @@ description: Master problem solver for systematic problem-solving methodologies.
 
 ## On Activation
 
+### Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ### Step 1: Resolve Activation Customization
 
 Resolve `persona`, `inject`, `additional_resources`, and `menu` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-agent-creative-problem-solver --key persona --key inject --key additional_resources --key menu`
+Run: `python3 scripts/resolve-customization.py bmad-cis-agent-creative-problem-solver --key persona --key inject --key additional_resources --key menu`
 Use the JSON output as resolved values.
 
 ### Step 2: Apply Customization
diff --git a/src/skills/bmad-cis-agent-design-thinking-coach/SKILL.md b/src/skills/bmad-cis-agent-design-thinking-coach/SKILL.md
@@ -5,10 +5,14 @@ description: Design thinking maestro for human-centered design processes. Use wh
 
 ## On Activation
 
+### Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ### Step 1: Resolve Activation Customization
 
 Resolve `persona`, `inject`, `additional_resources`, and `menu` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-agent-design-thinking-coach --key persona --key inject --key additional_resources --key menu`
+Run: `python3 scripts/resolve-customization.py bmad-cis-agent-design-thinking-coach --key persona --key inject --key additional_resources --key menu`
 Use the JSON output as resolved values.
 
 ### Step 2: Apply Customization
diff --git a/src/skills/bmad-cis-agent-innovation-strategist/SKILL.md b/src/skills/bmad-cis-agent-innovation-strategist/SKILL.md
@@ -5,10 +5,14 @@ description: Disruptive innovation oracle for business model innovation and stra
 
 ## On Activation
 
+### Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ### Step 1: Resolve Activation Customization
 
 Resolve `persona`, `inject`, `additional_resources`, and `menu` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-agent-innovation-strategist --key persona --key inject --key additional_resources --key menu`
+Run: `python3 scripts/resolve-customization.py bmad-cis-agent-innovation-strategist --key persona --key inject --key additional_resources --key menu`
 Use the JSON output as resolved values.
 
 ### Step 2: Apply Customization
diff --git a/src/skills/bmad-cis-agent-presentation-master/SKILL.md b/src/skills/bmad-cis-agent-presentation-master/SKILL.md
@@ -5,10 +5,14 @@ description: Visual communication and presentation expert for slide decks, pitch
 
 ## On Activation
 
+### Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ### Step 1: Resolve Activation Customization
 
 Resolve `persona`, `inject`, `additional_resources`, and `menu` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-agent-presentation-master --key persona --key inject --key additional_resources --key menu`
+Run: `python3 scripts/resolve-customization.py bmad-cis-agent-presentation-master --key persona --key inject --key additional_resources --key menu`
 Use the JSON output as resolved values.
 
 ### Step 2: Apply Customization
diff --git a/src/skills/bmad-cis-agent-storyteller/SKILL.md b/src/skills/bmad-cis-agent-storyteller/SKILL.md
@@ -5,10 +5,14 @@ description: Master storyteller for compelling narratives using proven framework
 
 ## On Activation
 
+### Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ### Step 1: Resolve Activation Customization
 
 Resolve `persona`, `inject`, `additional_resources`, and `menu` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-agent-storyteller --key persona --key inject --key additional_resources --key menu`
+Run: `python3 scripts/resolve-customization.py bmad-cis-agent-storyteller --key persona --key inject --key additional_resources --key menu`
 Use the JSON output as resolved values.
 
 ### Step 2: Apply Customization
diff --git a/src/skills/bmad-cis-design-thinking/SKILL.md b/src/skills/bmad-cis-design-thinking/SKILL.md
@@ -3,10 +3,14 @@ name: bmad-cis-design-thinking
 description: 'Guide human-centered design processes using empathy-driven methodologies. Use when the user says "lets run design thinking" or "I want to apply design thinking"'
 ---
 
+## Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ## Resolve Customization
 
 Resolve `inject` and `additional_resources` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-design-thinking --key inject --key additional_resources`
+Run: `python3 scripts/resolve-customization.py bmad-cis-design-thinking --key inject --key additional_resources`
 Use the JSON output as resolved values.
 
 If `inject.before` is not empty, incorporate its content as high-priority context.
@@ -17,6 +21,6 @@ Follow the instructions in [workflow.md](workflow.md).
 ## Post-Workflow Customization
 
 After the workflow completes, resolve `inject.after` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-design-thinking --key inject.after`
+Run: `python3 scripts/resolve-customization.py bmad-cis-design-thinking --key inject.after`
 
 If resolved `inject.after` is not empty, incorporate its content as a final checklist or validation gate.
diff --git a/src/skills/bmad-cis-innovation-strategy/SKILL.md b/src/skills/bmad-cis-innovation-strategy/SKILL.md
@@ -3,10 +3,14 @@ name: bmad-cis-innovation-strategy
 description: 'Identify disruption opportunities and architect business model innovation. Use when the user says "lets create an innovation strategy" or "I want to find disruption opportunities"'
 ---
 
+## Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ## Resolve Customization
 
 Resolve `inject` and `additional_resources` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-innovation-strategy --key inject --key additional_resources`
+Run: `python3 scripts/resolve-customization.py bmad-cis-innovation-strategy --key inject --key additional_resources`
 Use the JSON output as resolved values.
 
 If `inject.before` is not empty, incorporate its content as high-priority context.
@@ -17,6 +21,6 @@ Follow the instructions in [workflow.md](workflow.md).
 ## Post-Workflow Customization
 
 After the workflow completes, resolve `inject.after` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-innovation-strategy --key inject.after`
+Run: `python3 scripts/resolve-customization.py bmad-cis-innovation-strategy --key inject.after`
 
 If resolved `inject.after` is not empty, incorporate its content as a final checklist or validation gate.
diff --git a/src/skills/bmad-cis-problem-solving/SKILL.md b/src/skills/bmad-cis-problem-solving/SKILL.md
@@ -3,10 +3,14 @@ name: bmad-cis-problem-solving
 description: 'Apply systematic problem-solving methodologies to complex challenges. Use when the user says "guide me through structured problem solving" or "I want to crack this challenge with guided problem solving techniques"'
 ---
 
+## Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ## Resolve Customization
 
 Resolve `inject` and `additional_resources` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-problem-solving --key inject --key additional_resources`
+Run: `python3 scripts/resolve-customization.py bmad-cis-problem-solving --key inject --key additional_resources`
 Use the JSON output as resolved values.
 
 If `inject.before` is not empty, incorporate its content as high-priority context.
@@ -17,6 +21,6 @@ Follow the instructions in [workflow.md](workflow.md).
 ## Post-Workflow Customization
 
 After the workflow completes, resolve `inject.after` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-problem-solving --key inject.after`
+Run: `python3 scripts/resolve-customization.py bmad-cis-problem-solving --key inject.after`
 
 If resolved `inject.after` is not empty, incorporate its content as a final checklist or validation gate.
diff --git a/src/skills/bmad-cis-storytelling/SKILL.md b/src/skills/bmad-cis-storytelling/SKILL.md
@@ -3,10 +3,14 @@ name: bmad-cis-storytelling
 description: 'Craft compelling narratives using story frameworks. Use when the user says "help me with storytelling" or "I want to create a narrative through storytelling"'
 ---
 
+## Available Scripts
+
+- **`scripts/resolve-customization.py`** -- Resolves customization from three-layer TOML merge (user > team > defaults). Outputs JSON.
+
 ## Resolve Customization
 
 Resolve `inject` and `additional_resources` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-storytelling --key inject --key additional_resources`
+Run: `python3 scripts/resolve-customization.py bmad-cis-storytelling --key inject --key additional_resources`
 Use the JSON output as resolved values.
 
 If `inject.before` is not empty, incorporate its content as high-priority context.
@@ -17,6 +21,6 @@ Follow the instructions in [workflow.md](workflow.md).
 ## Post-Workflow Customization
 
 After the workflow completes, resolve `inject.after` from customization:
-Run: `python ./scripts/resolve-customization.py bmad-cis-storytelling --key inject.after`
+Run: `python3 scripts/resolve-customization.py bmad-cis-storytelling --key inject.after`
 
 If resolved `inject.after` is not empty, incorporate its content as a final checklist or validation gate.
