diff --git a/.changeset/fix-issue-521-yaml-skills.md b/.changeset/fix-issue-521-yaml-skills.md
new file mode 100644
index 00000000..4286739b
--- /dev/null
+++ b/.changeset/fix-issue-521-yaml-skills.md
@@ -0,0 +1 @@
+---\n"@googleworkspace/cli": patch\n---\n\nfix(skills): use block sequences for YAML frontmatter to improve compatibility with validation tools
diff --git a/src/generate_skills.rs b/src/generate_skills.rs
index 07cf41fa..53d00aa6 100644
--- a/src/generate_skills.rs
+++ b/src/generate_skills.rs
@@ -390,7 +390,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - "gws"
     cliHelp: "gws {alias} --help"
 ---
 
@@ -526,7 +527,8 @@ metadata:
   openclaw:
     category: "{category}"
     requires:
-      bins: ["gws"]
+      bins:
+        - "gws"
     cliHelp: "gws {alias} {cmd_name} --help"
 ---
 
@@ -673,7 +675,8 @@ metadata:
   openclaw:
     category: "productivity"
     requires:
-      bins: ["gws"]
+      bins:
+        - "gws"
 ---
 
 # gws — Shared Reference
@@ -773,7 +776,8 @@ metadata:
   openclaw:
     category: "persona"
     requires:
-      bins: ["gws"]
+      bins:
+        - "gws"
       skills: [{skills}]
 ---
 
@@ -844,7 +848,8 @@ metadata:
     category: "recipe"
     domain: "{category}"
     requires:
-      bins: ["gws"]
+      bins:
+        - "gws"
       skills: [{skills}]
 ---