diff --git a/skills/pass-mgr/SKILL.md b/skills/pass-mgr/SKILL.md
index ff5d8a7..fd5c50a 100644
--- a/skills/pass-mgr/SKILL.md
+++ b/skills/pass-mgr/SKILL.md
@@ -15,21 +15,30 @@ Always invoke pass_mgr through the `pcexec` tool. Do NOT run pass_mgr directly.
 
 - List keys for current agent
   - `pass_mgr list`
+  - Include shared scope: `pass_mgr list --public`
 
 - Get username for a key
-  - `pass_mgr get-username <key>`
+  - `pass_mgr get-username --key <key>`
+  - Shared scope: `pass_mgr get-username --public --key <key>`
 
 - Get secret for a key
-  - `pass_mgr get-secret <key>`
+  - `pass_mgr get-secret --key <key>`
+  - Shared scope: `pass_mgr get-secret --public --key <key>`
 
 - Set a key entry (username optional)
-  - `pass_mgr set <key> --secret <secret> [--username <username>]`
+  - `pass_mgr set --key <key> --secret <secret> [--username <username>]`
+  - Shared scope: `pass_mgr set --public --key <key> --secret <secret> [--username <username>]`
 
 - Remove a key entry
-  - `pass_mgr unset <key>`
+  - `pass_mgr unset --key <key>`
+  - Shared scope: `pass_mgr unset --public --key <key>`
 
 - Generate a random secret for a key (prints secret)
-  - `pass_mgr generate <key>`
+  - `pass_mgr generate --key <key> [--username <username>]`
+  - Shared scope: `pass_mgr generate --public --key <key> [--username <username>]`
+
+- Legacy (hidden) getter
+  - `pass_mgr get <key>`
 
 ## Usage notes