docs: clarify personal skill directories (#2032)

* docs: clarify personal skill directories

* docs: revert mirrored CLI beginners guide changes

Author: ProfTrader

instructions/agent-skills.instructions.md

@@ -25,7 +25,8 @@ Skills are stored in specific locations:
 |----------|-------|----------------|
 | `.github/skills/<skill-name>/` | Project/repository | Recommended for project skills |
 | `.claude/skills/<skill-name>/` | Project/repository | Legacy, for backward compatibility |
-| `~/.github/skills/<skill-name>/` | Personal (user-wide) | Recommended for personal skills |
+| `~/.copilot/skills/<skill-name>/` | Personal (user-wide) | Recommended for personal skills |
+| `~/.agents/skills/<skill-name>/` | Personal (user-wide) | Alternative supported personal skills directory |
 | `~/.claude/skills/<skill-name>/` | Personal (user-wide) | Legacy, for backward compatibility |
 
 Each skill **must** have its own subdirectory containing at minimum a `SKILL.md` file.

skills/cli-mastery/references/module-5-skills.md

@@ -10,13 +10,13 @@
 
 | Level | Location |
 |-------|----------|
-| User | `~/.copilot/skills/<name>/SKILL.md` |
+| User | `~/.copilot/skills/<name>/SKILL.md` or `~/.agents/skills/<name>/SKILL.md` |
 | Repo | `.github/skills/<name>/SKILL.md` |
 | Org | Shared via org-level config |
 
 ## Creating a custom skill
 
-1. Create the directory: `mkdir -p ~/.copilot/skills/my-skill/`
+1. Create the directory: `mkdir -p ~/.copilot/skills/my-skill/` (or `mkdir -p ~/.agents/skills/my-skill/`)
 2. Create `SKILL.md` with YAML frontmatter (`name`, `description`, optional `tools`)
 3. Write detailed instructions for the AI's behavior
 4. Verify with `/skills`

website/src/content/docs/learning-hub/copilot-configuration-basics.md

@@ -194,7 +194,7 @@ When you work inside `packages/api/`, Copilot loads configuration from `packages
 
 ### Personal Skills Directory
 
-In addition to repository-level skills, GitHub Copilot CLI supports a **personal skills directory** at `~/.agents/skills/`. Skills you place here are discovered automatically across all your projects, making them ideal for personal workflows and reusable utilities that are not project-specific.
+In addition to repository-level skills, GitHub Copilot CLI supports **personal skills directories** at `~/.copilot/skills/` and `~/.agents/skills/`. Skills you place in either location are discovered automatically across all your projects, making them ideal for personal workflows and reusable utilities that are not project-specific.
 
 ```
 ~/.agents/
@@ -205,7 +205,7 @@ In addition to repository-level skills, GitHub Copilot CLI supports a **personal
         └── SKILL.md
 ```
 
-This personal directory aligns with the VS Code GitHub Copilot for Azure extension's default skill discovery path, so skills defined here work consistently across tools.
+The `~/.agents/skills/` path aligns with the VS Code GitHub Copilot for Azure extension's default skill discovery path, while `~/.copilot/skills/` matches the Copilot CLI configuration directory. Both are supported for personal skills.
 
 ### Custom Agents
 
@@ -402,7 +402,7 @@ In addition to the main config file, GitHub Copilot CLI reads two optional per-p
 
 These files follow the same format as `config.json` and are loaded after the global config, so they can tailor CLI behaviour—including hook definitions—per repository without touching `.github/`.
 
-> **Important (v1.0.36+)**: Custom agents, skills, and commands placed in `~/.claude/` (the Claude Code user directory) are **no longer loaded** by GitHub Copilot CLI. Only `~/.claude/settings.json` is read for configuration. If you previously stored personal agents or skills in `~/.claude/`, move them to the supported locations: `~/.agents/` for user-level agents, `~/.agents/skills/` for personal skills, or `.github/agents/` and `.github/skills/` in your repositories for project-level customizations.
+> **Important (v1.0.36+)**: Custom agents, skills, and commands placed in `~/.claude/` (the Claude Code user directory) are **no longer loaded** by GitHub Copilot CLI. Only `~/.claude/settings.json` is read for configuration. If you previously stored personal agents or skills in `~/.claude/`, move them to the supported locations: `~/.copilot/agents/` for user-level agents, `~/.copilot/skills/` or `~/.agents/skills/` for personal skills, or `.github/agents/` and `.github/skills/` in your repositories for project-level customizations.
 
 ### Model Picker