diff --git a/docs/src/content/docs/guides/dependencies.md b/docs/src/content/docs/guides/dependencies.md
index f8ba9800..a5173b97 100644
--- a/docs/src/content/docs/guides/dependencies.md
+++ b/docs/src/content/docs/guides/dependencies.md
@@ -50,16 +50,16 @@ apm install ComposioHQ/awesome-claude-skills/brand-guidelines
 
 #### Skill Integration During Install
 
-Skills are integrated to `.github/skills/`:
+Skills are integrated to the target-specific skills directory (e.g., `.github/skills/` for copilot, `.cursor/skills/` for cursor):
 
 | Source | Result |
 |--------|--------|
-| Package with `SKILL.md` | Skill folder copied to `.github/skills/{folder-name}/` |
+| Package with `SKILL.md` | Skill folder copied to `{target}/skills/{folder-name}/` |
 | Package without `SKILL.md` | No skill folder created |
 
 #### Skill Folder Naming
 
-Skill folders use the **source folder name directly** (not flattened paths):
+Skill folders use the **source folder name directly** (not flattened paths). Example for the default copilot target:
 
 ```
 .github/skills/
diff --git a/docs/src/content/docs/guides/skills.md b/docs/src/content/docs/guides/skills.md
index 9cdb59ec..c0aa62e6 100644
--- a/docs/src/content/docs/guides/skills.md
+++ b/docs/src/content/docs/guides/skills.md
@@ -251,11 +251,11 @@ my-package/
             └── SKILL.md  # Sub-skill B
 ```
 
-On install, APM promotes each sub-skill to a top-level `.github/skills/` entry alongside the parent — see [Sub-skill Promotion](#sub-skill-promotion) below.
+On install, APM promotes each sub-skill to a top-level `{target}/skills/` entry alongside the parent — see [Sub-skill Promotion](#sub-skill-promotion) below.
 
 ### Sub-skill Promotion
 
-When a package contains sub-skills in `.apm/skills/*/` subdirectories, APM promotes each to a top-level entry under `.github/skills/`. This ensures Copilot can discover them independently, since it only scans direct children of `.github/skills/`.
+When a package contains sub-skills in `.apm/skills/*/` subdirectories, APM promotes each to a top-level entry under `{target}/skills/` (e.g., `.github/skills/`, `.cursor/skills/`, `.opencode/skills/` depending on the active target). This ensures each supported IDE can discover them independently.
 
 ```
 # Installed package with sub-skills:
@@ -266,12 +266,19 @@ apm_modules/org/repo/my-package/
         └── azure-naming/
             └── SKILL.md
 
-# Result after install:
+# Result after install (default/copilot target):
 .github/skills/
 ├── my-package/              # Parent skill
 │   └── SKILL.md
 └── azure-naming/            # Promoted sub-skill
     └── SKILL.md
+
+# Result after install (--target cursor):
+.cursor/skills/
+├── my-package/
+│   └── SKILL.md
+└── azure-naming/
+    └── SKILL.md
 ```
 
 ## Package Detection