diff --git a/.changeset/drive-supportsAllDrives-docs.md b/.changeset/drive-supportsAllDrives-docs.md
new file mode 100644
index 00000000..5962c39c
--- /dev/null
+++ b/.changeset/drive-supportsAllDrives-docs.md
@@ -0,0 +1,5 @@
+---
+"@googleworkspace/cli": patch
+---
+
+Add Shared Drives tip to gws-drive skill doc explaining supportsAllDrives usage
diff --git a/skills/gws-drive/SKILL.md b/skills/gws-drive/SKILL.md
index d22766b2..36e583b8 100644
--- a/skills/gws-drive/SKILL.md
+++ b/skills/gws-drive/SKILL.md
@@ -135,3 +135,17 @@ gws schema drive.<resource>.<method>
 
 Use `gws schema` output to build your `--params` and `--json` flags.
 
+## Shared Drives
+
+Most `files` and `permissions` methods only search **My Drive** by default.
+To include Shared Drive content, pass `supportsAllDrives: true` in `--params`:
+
+```bash
+# list files in a shared drive
+gws drive files list --params '{"corpora": "drive", "driveId": "DRIVE_ID", "supportsAllDrives": true, "includeItemsFromAllDrives": true}'
+
+# get a file that lives in a shared drive
+gws drive files get --params '{"fileId": "FILE_ID", "supportsAllDrives": true}'
+```
+
+If a file or folder isn't found, ensure your request includes all necessary parameters for Shared Drive access (e.g., `supportsAllDrives: true`, `includeItemsFromAllDrives: true`).