diff --git a/content/docs/cli/skills/index.mdx b/content/docs/cli/skills/index.mdx
index a7bd058..69aa38a 100644
--- a/content/docs/cli/skills/index.mdx
+++ b/content/docs/cli/skills/index.mdx
@@ -38,20 +38,30 @@ The canonical skill files live in the docs repo at `skills/<name>/SKILL.md` and
 
 ## Install
 
-The skill files are hosted in [`webrenew/mogplex-docs`](https://github.com/webrenew/mogplex-docs) under `skills/`. Fetch them first, then copy into your agent host.
+The skill files are hosted in [`webrenew/mogplex-docs`](https://github.com/webrenew/mogplex-docs) under `skills/`. Pick one fetch method (this sets a `SKILLS` path variable), then copy into your agent host.
 
 ### Claude Code
 
 ```bash
-# Fetch just the skills/ tree (no full clone needed)
+# Option A — full clone
+git clone https://github.com/webrenew/mogplex-docs.git
+SKILLS=mogplex-docs/skills
+
+# Option B — sparse download of just the skills/ tree
+#   degit copies the *contents* of skills/ into mogplex-skills/,
+#   so mogplex-skills is the skills tree (no nested skills/ dir).
 npx -y degit webrenew/mogplex-docs/skills mogplex-skills
-cd mogplex-skills
+SKILLS=mogplex-skills
+```
 
+Then, in the same shell:
+
+```bash
 # Global
-mkdir -p ~/.claude/skills && cp -R . ~/.claude/skills/
+mkdir -p ~/.claude/skills && cp -R "$SKILLS"/* ~/.claude/skills/
 
-# Or per-project (run from your project root, not the downloaded skills dir)
-mkdir -p .claude/skills && cp -R /path/to/mogplex-skills/* .claude/skills/
+# Or per-project (run from your project root)
+mkdir -p .claude/skills && cp -R "$SKILLS"/* .claude/skills/
 ```
 
 ### Claude Agent SDK
diff --git a/content/docs/extend/skills.mdx b/content/docs/extend/skills.mdx
index 48bd135..cc73fe7 100644
--- a/content/docs/extend/skills.mdx
+++ b/content/docs/extend/skills.mdx
@@ -44,26 +44,28 @@ When the MCP server ships, both paths will stay supported. Skills will continue
 
 ## Install
 
-First fetch the skill files from [`webrenew/mogplex-docs`](https://github.com/webrenew/mogplex-docs). Either clone the repo or download the `skills/` tree directly:
+The skills live in [`webrenew/mogplex-docs`](https://github.com/webrenew/mogplex-docs) under `skills/`. Pick one fetch method, which sets a `SKILLS` path variable used by the copy step below:
 
 ```bash
-# Option A — clone and cd
+# Option A — full clone (gives you the rest of the docs repo too)
 git clone https://github.com/webrenew/mogplex-docs.git
-cd mogplex-docs
+SKILLS=mogplex-docs/skills
 
 # Option B — sparse download of just the skills/ tree
+#   degit copies the *contents* of skills/ into mogplex-skills/,
+#   so mogplex-skills is the skills tree (no nested skills/ dir).
 npx -y degit webrenew/mogplex-docs/skills mogplex-skills
-cd mogplex-skills && cd ..    # or rename the dir as you like
+SKILLS=mogplex-skills
 ```
 
-Then copy the `skills/` contents into your agent host:
+Then copy into your agent host. Both commands run from the same shell where you set `$SKILLS`:
 
 ```bash
-# Global (Claude Code) — run from the directory containing `skills/`
-mkdir -p ~/.claude/skills && cp -R skills/* ~/.claude/skills/
+# Global (Claude Code)
+mkdir -p ~/.claude/skills && cp -R "$SKILLS"/* ~/.claude/skills/
 
-# Or per-project
-mkdir -p .claude/skills && cp -R skills/* .claude/skills/
+# Or per-project (run from your project root)
+mkdir -p .claude/skills && cp -R "$SKILLS"/* .claude/skills/
 ```
 
 See [CLI → Skills](/cli/skills) for Agent SDK integration, Cursor instructions, and the full install matrix.
diff --git a/skills/README.md b/skills/README.md
index 488a9b4..fb06c33 100644
--- a/skills/README.md
+++ b/skills/README.md
@@ -20,6 +20,8 @@ Each subdirectory is a single skill with a `SKILL.md` using standard YAML frontm
 
 ## Install into Claude Code
 
+Run from the `mogplex-docs` repo root (the directory that contains this `skills/` folder):
+
 ```bash
 # Global install
 mkdir -p ~/.claude/skills && cp -R skills/* ~/.claude/skills/
@@ -28,6 +30,8 @@ mkdir -p ~/.claude/skills && cp -R skills/* ~/.claude/skills/
 mkdir -p .claude/skills && cp -R skills/* .claude/skills/
 ```
 
+If you pulled the skills tree with `npx degit webrenew/mogplex-docs/skills mogplex-skills` instead (so there is no outer `skills/` directory), run the copy as `cp -R mogplex-skills/* ~/.claude/skills/`.
+
 ## Install into an Agent SDK app
 
 ```ts