diff --git a/docs/skill-authoring-guide.md b/docs/skill-authoring-guide.md
index bc4d260..4e74391 100644
--- a/docs/skill-authoring-guide.md
+++ b/docs/skill-authoring-guide.md
@@ -20,7 +20,10 @@ Every skill has two parts: YAML frontmatter and a markdown body.
 ---
 name: my-skill-name
 description: One-line description explaining when to use this skill and what it produces.
-allowed-tools: Read, Write, Shell
+allowed-tools:
+  - Read
+  - Write
+  - Shell
 ---
 ```
 
@@ -368,7 +371,9 @@ description: >-
   to improve test quality, or before a major release. Do not use
   for writing tests (use a test-writing skill instead) or for
   linting/style checks.
-allowed-tools: Read, Shell
+allowed-tools:
+  - Read
+  - Shell
 ---
 ```
 
diff --git a/plugins/trogonstack-ask/skills/ask-question/SKILL.md b/plugins/trogonstack-ask/skills/ask-question/SKILL.md
index 5ecadcc..800b13d 100644
--- a/plugins/trogonstack-ask/skills/ask-question/SKILL.md
+++ b/plugins/trogonstack-ask/skills/ask-question/SKILL.md
@@ -5,7 +5,10 @@ description: >-
   clarification. Each question includes the intention behind it and current
   assumptions. Use when the user wants to be interviewed about a topic, gather
   requirements, or needs help thinking through a problem step by step.
-allowed-tools: Read, Write, AskUserQuestion
+allowed-tools:
+  - Read
+  - Write
+  - AskUserQuestion
 ---
 
 # Ask Question
diff --git a/plugins/trogonstack-datadog/skills/datadog-design-dashboard/SKILL.md b/plugins/trogonstack-datadog/skills/datadog-design-dashboard/SKILL.md
index b1af480..9e7d6b0 100644
--- a/plugins/trogonstack-datadog/skills/datadog-design-dashboard/SKILL.md
+++ b/plugins/trogonstack-datadog/skills/datadog-design-dashboard/SKILL.md
@@ -10,7 +10,11 @@ description: >-
   Do not use for: (1) Datadog agent installation or configuration,
   (2) monitor/alert rule design, (3) APM instrumentation or tracing setup,
   (4) log pipeline configuration.
-allowed-tools: AskUserQuestion, Write, Read, Shell
+allowed-tools:
+  - AskUserQuestion
+  - Write
+  - Read
+  - Shell
 ---
 
 # Design Datadog Dashboard
diff --git a/plugins/trogonstack-diataxis/skills/diataxis-gen-readme/SKILL.md b/plugins/trogonstack-diataxis/skills/diataxis-gen-readme/SKILL.md
index bb8f341..656f868 100644
--- a/plugins/trogonstack-diataxis/skills/diataxis-gen-readme/SKILL.md
+++ b/plugins/trogonstack-diataxis/skills/diataxis-gen-readme/SKILL.md
@@ -1,7 +1,9 @@
 ---
 name: diataxis-gen-readme
 description: Generate a README introduction following the Diataxis 4-paragraph structure for product documentation.
-allowed-tools: Read, Write
+allowed-tools:
+  - Read
+  - Write
 ---
 
 Generate a README introduction following this 4-paragraph structure, replacing the placeholder text with content specific to the product:
diff --git a/plugins/trogonstack-diataxis/skills/diataxis-organize-docs/SKILL.md b/plugins/trogonstack-diataxis/skills/diataxis-organize-docs/SKILL.md
index 6bf1c92..5b2d2e4 100644
--- a/plugins/trogonstack-diataxis/skills/diataxis-organize-docs/SKILL.md
+++ b/plugins/trogonstack-diataxis/skills/diataxis-organize-docs/SKILL.md
@@ -1,7 +1,9 @@
 ---
 name: diataxis-organize-docs
 description: Reorganize documentation into the Diataxis framework structure. Splits existing docs into tutorials, how-to guides, reference, and explanation sections.
-allowed-tools: Read, Write
+allowed-tools:
+  - Read
+  - Write
 ---
 
 # Diataxis Documentation Organization
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-applying-conways-law/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-applying-conways-law/SKILL.md
index c804d8a..bc720c1 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-applying-conways-law/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-applying-conways-law/SKILL.md
@@ -6,7 +6,9 @@ description: >-
   after defining inputs/outputs. Do not use for: planning feature slice
   implementation order (use eventmodeling-slicing-event-models) or defining
   command/read model boundaries (use eventmodeling-designing-event-models).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Applying Conway's Law
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-brainstorming-events/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-brainstorming-events/SKILL.md
index c84f4e5..e5c04ae 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-brainstorming-events/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-brainstorming-events/SKILL.md
@@ -7,7 +7,9 @@ description: >-
   events in sequence (use eventmodeling-plotting-events), designing commands
   or read models (use eventmodeling-designing-event-models), or when a complete
   event list already exists.
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Brainstorming Events
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-checking-completeness/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-checking-completeness/SKILL.md
index c9cd3da..32d73b9 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-checking-completeness/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-checking-completeness/SKILL.md
@@ -6,7 +6,8 @@ description: >-
   all scenarios defined. Do not use for: architectural validation against event sourcing
   principles (use eventmodeling-validating-event-models) or elaborating
   Given-When-Then specs (use eventmodeling-elaborating-scenarios).
-allowed-tools: Write
+allowed-tools:
+  - Write
 ---
 
 # Checking Completeness
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-designing-event-models/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-designing-event-models/SKILL.md
index afaa782..5417a26 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-designing-event-models/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-designing-event-models/SKILL.md
@@ -8,7 +8,9 @@ description: >-
   scratch (use eventmodeling-brainstorming-events), optimizing stream sizing
   or snapshotting (use eventmodeling-optimizing-stream-design), or translating
   external system events (use eventmodeling-translating-external-events).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Designing Event Models
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-elaborating-scenarios/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-elaborating-scenarios/SKILL.md
index 84fe914..89f8d87 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-elaborating-scenarios/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-elaborating-scenarios/SKILL.md
@@ -7,7 +7,9 @@ description: >-
   architectural validation (use eventmodeling-validating-event-models) or
   verifying field completeness across the model (use
   eventmodeling-checking-completeness).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Elaborating Scenarios
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-identifying-inputs/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-identifying-inputs/SKILL.md
index f5625fc..0a9968e 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-identifying-inputs/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-identifying-inputs/SKILL.md
@@ -6,7 +6,9 @@ description: >-
   Do not use for: identifying read models or outputs (use
   eventmodeling-identifying-outputs) or elaborating behavior specifications
   (use eventmodeling-elaborating-scenarios).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Identifying Inputs
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-identifying-outputs/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-identifying-outputs/SKILL.md
index e059d6f..76aef3a 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-identifying-outputs/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-identifying-outputs/SKILL.md
@@ -5,7 +5,9 @@ description: >-
   what data flows back to UI and Processors. Use after defining inputs. Do not
   use for: identifying commands or inputs (use eventmodeling-identifying-inputs)
   or verifying field completeness (use eventmodeling-checking-completeness).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Identifying Outputs
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-integrating-legacy-systems/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-integrating-legacy-systems/SKILL.md
index 86b4b8a..debf12f 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-integrating-legacy-systems/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-integrating-legacy-systems/SKILL.md
@@ -7,7 +7,9 @@ description: >-
   existing legacy constraints (use eventmodeling-orchestrating-event-modeling)
   or translating inbound events from external APIs (use
   eventmodeling-translating-external-events).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Integrating Legacy Systems
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-optimizing-stream-design/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-optimizing-stream-design/SKILL.md
index 341b9be..c06a929 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-optimizing-stream-design/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-optimizing-stream-design/SKILL.md
@@ -7,7 +7,9 @@ description: >-
   stream design before implementation. Do not use for: designing the initial
   event model structure (use eventmodeling-designing-event-models) or
   general architectural validation (use eventmodeling-validating-event-models).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Optimizing Stream Design
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-orchestrating-event-modeling/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-orchestrating-event-modeling/SKILL.md
index 21f4477..91fd52c 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-orchestrating-event-modeling/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-orchestrating-event-modeling/SKILL.md
@@ -9,7 +9,9 @@ description: >-
   eventmodeling-elaborating-scenarios for Step 7), validating an
   already-completed model (use eventmodeling-validating-event-models), or
   modernizing legacy systems (use eventmodeling-integrating-legacy-systems).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Orchestrating Event Modeling
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-plotting-events/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-plotting-events/SKILL.md
index 9e74ab8..486d68a 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-plotting-events/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-plotting-events/SKILL.md
@@ -6,7 +6,8 @@ description: >-
   brainstorming events. Do not use for: brainstorming new events (use
   eventmodeling-brainstorming-events) or designing command/read model
   architecture (use eventmodeling-designing-event-models).
-allowed-tools: Write
+allowed-tools:
+  - Write
 ---
 
 # Plotting Events
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-slicing-event-models/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-slicing-event-models/SKILL.md
index 961cf39..441499f 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-slicing-event-models/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-slicing-event-models/SKILL.md
@@ -9,7 +9,9 @@ description: >-
   eventmodeling-applying-conways-law) or planning before the event model is
   complete (complete the full model first using
   eventmodeling-orchestrating-event-modeling).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Slicing Event Models
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-storyboarding-events/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-storyboarding-events/SKILL.md
index f5abc46..3fb367d 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-storyboarding-events/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-storyboarding-events/SKILL.md
@@ -6,7 +6,9 @@ description: >-
   after sequencing events. Do not use for: identifying commands or processor
   actions (use eventmodeling-identifying-inputs) or designing read models
   (use eventmodeling-identifying-outputs).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Storyboarding Events
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-translating-external-events/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-translating-external-events/SKILL.md
index 91c2c71..1aab218 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-translating-external-events/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-translating-external-events/SKILL.md
@@ -7,7 +7,9 @@ description: >-
   modernizing legacy systems using the side-car pattern (use
   eventmodeling-integrating-legacy-systems) or designing command handlers for
   the translated events (use eventmodeling-designing-event-models).
-allowed-tools: AskUserQuestion, Write
+allowed-tools:
+  - AskUserQuestion
+  - Write
 ---
 
 # Translating External Events
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-validating-event-models-checklist/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-validating-event-models-checklist/SKILL.md
index 59344d7..8cee57e 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-validating-event-models-checklist/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-validating-event-models-checklist/SKILL.md
@@ -7,7 +7,8 @@ description: >-
   completing event modeling steps. Do not use for: reviewing incomplete or
   in-progress models (use eventmodeling-validating-event-models), or for
   elaborating new scenarios (use eventmodeling-elaborating-scenarios).
-allowed-tools: Write
+allowed-tools:
+  - Write
 ---
 
 # Event Model Validation Checklist Skill
diff --git a/plugins/trogonstack-eventmodeling/skills/eventmodeling-validating-event-models/SKILL.md b/plugins/trogonstack-eventmodeling/skills/eventmodeling-validating-event-models/SKILL.md
index 8630794..591395e 100644
--- a/plugins/trogonstack-eventmodeling/skills/eventmodeling-validating-event-models/SKILL.md
+++ b/plugins/trogonstack-eventmodeling/skills/eventmodeling-validating-event-models/SKILL.md
@@ -8,7 +8,8 @@ description: >-
   code generation. Do not use for: the structured 23-check production checklist
   (use eventmodeling-validating-event-models-checklist) or field-level
   completeness verification (use eventmodeling-checking-completeness).
-allowed-tools: Write
+allowed-tools:
+  - Write
 ---
 
 # Validating Event Models
diff --git a/plugins/trogonstack-nats/skills/nats-design-subject/SKILL.md b/plugins/trogonstack-nats/skills/nats-design-subject/SKILL.md
index bff1e31..13e44e4 100644
--- a/plugins/trogonstack-nats/skills/nats-design-subject/SKILL.md
+++ b/plugins/trogonstack-nats/skills/nats-design-subject/SKILL.md
@@ -9,7 +9,11 @@ description: >-
   setup, (2) client library implementation or connection code, (3) debugging
   connectivity or performance issues, (4) choosing between NATS and other
   messaging systems.
-allowed-tools: AskUserQuestion, Write, Read, Shell
+allowed-tools:
+  - AskUserQuestion
+  - Write
+  - Read
+  - Shell
 ---
 
 # Design NATS Subject Hierarchy
diff --git a/plugins/trogonstack-otel/skills/otel-name-metric/SKILL.md b/plugins/trogonstack-otel/skills/otel-name-metric/SKILL.md
index 20f0f9e..1cfdb87 100644
--- a/plugins/trogonstack-otel/skills/otel-name-metric/SKILL.md
+++ b/plugins/trogonstack-otel/skills/otel-name-metric/SKILL.md
@@ -7,7 +7,11 @@ description: >-
   metric naming consistency. Do not use for: (1) span or trace naming, (2) OTel
   collector configuration, (3) SDK installation or setup, (4) alerting or
   dashboard design.
-allowed-tools: AskUserQuestion, Write, Read, Shell
+allowed-tools:
+  - AskUserQuestion
+  - Write
+  - Read
+  - Shell
 ---
 
 # Review or Create OpenTelemetry Metric Names
diff --git a/plugins/trogonstack-otel/skills/otel-name-span/SKILL.md b/plugins/trogonstack-otel/skills/otel-name-span/SKILL.md
index 15393ac..7ec7751 100644
--- a/plugins/trogonstack-otel/skills/otel-name-span/SKILL.md
+++ b/plugins/trogonstack-otel/skills/otel-name-span/SKILL.md
@@ -7,7 +7,11 @@ description: >-
   or auditing span naming consistency. Do not use for: (1) metric naming, (2)
   OTel collector configuration, (3) SDK installation or setup, (4) alerting or
   dashboard design.
-allowed-tools: AskUserQuestion, Write, Read, Shell
+allowed-tools:
+  - AskUserQuestion
+  - Write
+  - Read
+  - Shell
 ---
 
 # Review or Create OpenTelemetry Span Names