From ff29a3bdd69d7f0ef55709875ea2b900b904e406 Mon Sep 17 00:00:00 2001
From: Copilot <copilot@github.com>
Date: Tue, 31 Mar 2026 03:45:41 +0000
Subject: [PATCH] docs: clarify target-aware skill deployment paths (v0.8.7)

Skill deployment has always been target-aware, but two documentation
sections hardcoded `.github/skills/` as if it were the only destination.
Update both sections to use `{target}/skills/` notation and add a
concrete `--target cursor` example showing `.cursor/skills/` output,
matching the v0.8.7 fix that made SkillIntegrator respect explicit
--target flags end-to-end.

- guides/dependencies.md: update Skill Integration table and intro
- guides/skills.md: update sub-skill promotion description and example

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/src/content/docs/guides/dependencies.md |  6 +++---
 docs/src/content/docs/guides/skills.md       | 13 ++++++++++---
 2 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/docs/src/content/docs/guides/dependencies.md b/docs/src/content/docs/guides/dependencies.md
index 6064fd33..8482d3b2 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 d4d6bff6..3db308c7 100644
--- a/docs/src/content/docs/guides/skills.md
+++ b/docs/src/content/docs/guides/skills.md
@@ -250,11 +250,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:
@@ -265,12 +265,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