diff --git a/assets/ios-skills.txt b/assets/ios-skills.txt
index e10d862..67a4489 100644
--- a/assets/ios-skills.txt
+++ b/assets/ios-skills.txt
@@ -1,4 +1,5 @@
 # iOS Skills
 # Each line is passed to: npx skills add <line>
+# Format: owner/repo@skill (from npx skills find)
 
-https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill
+avdlee/swiftui-agent-skill@swiftui-expert-skill
diff --git a/docs/ai/skills.md b/docs/ai/skills.md
index 6b1ccbe..99c7311 100644
--- a/docs/ai/skills.md
+++ b/docs/ai/skills.md
@@ -59,7 +59,7 @@ Skills files are plain text. Each non-empty, non-comment line is passed to `npx
 
 ```text
 # iOS Skills
-https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill
+avdlee/swiftui-agent-skill@swiftui-expert-skill
 ```
 
 ### Sync Workflow
@@ -100,7 +100,7 @@ The CLI runs via `npx`, so you do not need a global install.
 ### Example Install Entry
 Add one line to the platform file (e.g., `ios-skills.txt`):
 ```text
-https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill
+avdlee/swiftui-agent-skill@swiftui-expert-skill
 ```
 
 ### Notes