From e40c041533ffd58ba136e452f2da615d344a23ee Mon Sep 17 00:00:00 2001 From: ProfTrader <3li8@proton.me> Date: Fri, 19 Jun 2026 05:50:00 +0530 Subject: [PATCH] docs: clarify personal skill directories (#2032) * docs: clarify personal skill directories * docs: revert mirrored CLI beginners guide changes --- instructions/agent-skills.instructions.md | 3 ++- skills/cli-mastery/references/module-5-skills.md | 4 ++-- .../docs/learning-hub/copilot-configuration-basics.md | 6 +++--- 3 files changed, 7 insertions(+), 6 deletions(-) diff --git a/instructions/agent-skills.instructions.md b/instructions/agent-skills.instructions.md index 440d5831..9c0bc7cf 100644 --- a/instructions/agent-skills.instructions.md +++ b/instructions/agent-skills.instructions.md @@ -25,7 +25,8 @@ Skills are stored in specific locations: |----------|-------|----------------| | `.github/skills//` | Project/repository | Recommended for project skills | | `.claude/skills//` | Project/repository | Legacy, for backward compatibility | -| `~/.github/skills//` | Personal (user-wide) | Recommended for personal skills | +| `~/.copilot/skills//` | Personal (user-wide) | Recommended for personal skills | +| `~/.agents/skills//` | Personal (user-wide) | Alternative supported personal skills directory | | `~/.claude/skills//` | Personal (user-wide) | Legacy, for backward compatibility | Each skill **must** have its own subdirectory containing at minimum a `SKILL.md` file. diff --git a/skills/cli-mastery/references/module-5-skills.md b/skills/cli-mastery/references/module-5-skills.md index b9f920f0..9524c646 100644 --- a/skills/cli-mastery/references/module-5-skills.md +++ b/skills/cli-mastery/references/module-5-skills.md @@ -10,13 +10,13 @@ | Level | Location | |-------|----------| -| User | `~/.copilot/skills//SKILL.md` | +| User | `~/.copilot/skills//SKILL.md` or `~/.agents/skills//SKILL.md` | | Repo | `.github/skills//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` diff --git a/website/src/content/docs/learning-hub/copilot-configuration-basics.md b/website/src/content/docs/learning-hub/copilot-configuration-basics.md index a9ea157d..bf004b6e 100644 --- a/website/src/content/docs/learning-hub/copilot-configuration-basics.md +++ b/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