sync: update from private repo (edc775f2)

docs/tools/skills.md

@@ -6,6 +6,11 @@ Piece の取得・編集には GetPiece / CreatePiece / UpdatePiece を使う。
 利用可能なスキル一覧はシステムプロンプトの **Skills Index** に出る。本文を読むには
 `ReadSkill({ name: "..." })` を呼ぶ。
 
+> **重要: スキルを `Read` で直接読もうとしないこと。** スキルは workspace の外に
+> 保存されており、`Read("skills/<name>/SKILL.md")` のようなパスは（ディレクトリ型を
+> ReadSkill で展開する前は）存在しない。まず `ReadSkill({ name })` を呼ぶ。ディレクトリ型は
+> それで `skills/<name>/` に展開され、以後は `skills/<name>/...` を `Read` で読める。
+
 ## ツール
 
 - **InstallSkill** — スキルを保存する。通常は `content` に SKILL.md 全文（YAML frontmatter + 本文）を渡す。workspace 内に `SKILL.md` と `scripts/` 等を含むディレクトリを組み立て済みなら `sourcePath`（workspace 内の絶対パス）を渡す。`scope` は `user`（個人 or 共有ワークスペース）か `system`（全ユーザー共有・admin のみ）。