From 38c8027ff0ae858869db0edbe440ed6b03698c6c Mon Sep 17 00:00:00 2001
From: Aldrich_CC <109075336+Chen17-sq@users.noreply.github.com>
Date: Sat, 16 May 2026 05:18:42 +0800
Subject: [PATCH] docs(file-formats): note comma-separated form for claudecode
 skill paths

Addresses item 3 in #1618. The claudecode.paths Zod schema accepts z.union([z.string(), z.array(z.string())]), but the file-formats reference only showed the YAML list form. Add a one-sentence callout right after the SKILL.md example that names the comma-separated string form and shows the equivalent value, so the documented surface matches the schema.

Doc-only change; skills/rulesync/file-formats.md is regenerated by scripts/sync-skill-docs.ts via the lint-staged hook.
---
 docs/reference/file-formats.md  | 2 ++
 skills/rulesync/file-formats.md | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/docs/reference/file-formats.md b/docs/reference/file-formats.md
index 7064985db..69b2ac42a 100644
--- a/docs/reference/file-formats.md
+++ b/docs/reference/file-formats.md
@@ -296,6 +296,8 @@ Skills are directory-based and can include additional files alongside SKILL.md.
 When `claudecode.scheduled-task: true` is set, that skill is emitted only as a Claude Code scheduled task and is not emitted to other tools even if `targets` contains `"*"`.
 ```
 
+`claudecode.paths` accepts either the YAML list shown above or a comma-separated string (e.g. `paths: "src/**/*.ts,test/**/*.ts"`); the two forms are equivalent.
+
 ## `.rulesync/mcp.json`
 
 Example:
diff --git a/skills/rulesync/file-formats.md b/skills/rulesync/file-formats.md
index 7064985db..69b2ac42a 100644
--- a/skills/rulesync/file-formats.md
+++ b/skills/rulesync/file-formats.md
@@ -296,6 +296,8 @@ Skills are directory-based and can include additional files alongside SKILL.md.
 When `claudecode.scheduled-task: true` is set, that skill is emitted only as a Claude Code scheduled task and is not emitted to other tools even if `targets` contains `"*"`.
 ```
 
+`claudecode.paths` accepts either the YAML list shown above or a comma-separated string (e.g. `paths: "src/**/*.ts,test/**/*.ts"`); the two forms are equivalent.
+
 ## `.rulesync/mcp.json`
 
 Example: