From 57c99e028c04e0bee096f134cd0f27c6eb94626a Mon Sep 17 00:00:00 2001 From: Lewis Llobera <35342598+lewislbr@users.noreply.github.com> Date: Thu, 19 Mar 2026 10:49:41 +0100 Subject: [PATCH 1/6] Add .agents/skills skill storage paths in documentation Added the `.agents/skills` project and personal paths as they are a convention stated in https://agentskills.io/client-implementation/adding-skills-support#where-to-scan for cross-client skill sharing. --- data/reusables/copilot/creating-adding-skills.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data/reusables/copilot/creating-adding-skills.md b/data/reusables/copilot/creating-adding-skills.md index 65a57707d7ad..8315759ca2b3 100644 --- a/data/reusables/copilot/creating-adding-skills.md +++ b/data/reusables/copilot/creating-adding-skills.md @@ -6,9 +6,9 @@ To add a skill, you save the `SKILL.md` file, and any subsidiary resources, to a 1. Create a `skills` directory to store your skill and any others you may want to create in the future. - For **project skills**, specific to a single repository, store your skill under `.github/skills` or `.claude/skills`. + For **project skills**, specific to a single repository, store your skill under `.agents/skills`, `.github/skills` or `.claude/skills`. - For **personal skills**, shared across projects, store your skill under `~/.copilot/skills` or `~/.claude/skills`. + For **personal skills**, shared across projects, store your skill under `~/.agents/skills`, `~/.copilot/skills` or `~/.claude/skills`. 1. Create a subdirectory for your new skill. Each skill should have its own directory (for example, `.github/skills/webapp-testing`). From 095cdd30f1252fe196a7e5a5115d9189e3e4dfa6 Mon Sep 17 00:00:00 2001 From: Lewis Llobera <35342598+lewislbr@users.noreply.github.com> Date: Thu, 19 Mar 2026 10:58:08 +0100 Subject: [PATCH 2/6] Add .agents/skills skill storage paths in documentation --- content/copilot/concepts/agents/about-agent-skills.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/copilot/concepts/agents/about-agent-skills.md b/content/copilot/concepts/agents/about-agent-skills.md index fa6f689dc765..762ae91c1bde 100644 --- a/content/copilot/concepts/agents/about-agent-skills.md +++ b/content/copilot/concepts/agents/about-agent-skills.md @@ -22,8 +22,8 @@ You can create your own skills to teach {% data variables.product.prodname_copil {% data variables.product.prodname_copilot_short %} supports: -* Project skills, stored in your repository (`.github/skills` or `.claude/skills`) -* Personal skills, stored in your home directory and shared across projects (`~/.copilot/skills` or `~/.claude/skills`) ({% data variables.copilot.copilot_coding_agent %} and {% data variables.copilot.copilot_cli %} only) +* Project skills, stored in your repository (`.agents/skills`, `.github/skills` or `.claude/skills`) +* Personal skills, stored in your home directory and shared across projects (`~/.agents/skills`, `~/.copilot/skills` or `~/.claude/skills`) ({% data variables.copilot.copilot_coding_agent %} and {% data variables.copilot.copilot_cli %} only) Support for organization-level and enterprise-level skills is coming soon. From 33441d7f46f47d8647c8b1525795c9d5887c0f33 Mon Sep 17 00:00:00 2001 From: Lewis Llobera <35342598+lewislbr@users.noreply.github.com> Date: Thu, 19 Mar 2026 12:44:18 +0100 Subject: [PATCH 3/6] Add .agents/skills skill storage paths in documentation --- .../copilot-cli-reference/cli-plugin-reference.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/content/copilot/reference/copilot-cli-reference/cli-plugin-reference.md b/content/copilot/reference/copilot-cli-reference/cli-plugin-reference.md index 0c7aa646287b..fcac7906753f 100644 --- a/content/copilot/reference/copilot-cli-reference/cli-plugin-reference.md +++ b/content/copilot/reference/copilot-cli-reference/cli-plugin-reference.md @@ -193,9 +193,10 @@ The following diagram illustrates the loading order and precedence rules. │ 3. /.claude/skills/ (project) │ │ 4. /.github/skills/ etc. (inherited) │ │ 5. ~/.copilot/skills/ (personal-copilot) │ - │ 6. ~/.claude/skills/ (personal-claude) │ - │ 7. PLUGIN: skills/ dirs (plugin) │ - │ 8. COPILOT_SKILLS_DIRS env + config (custom) │ + │ 6. ~/.agents/skills/ (personal-skills) │ + │ 7. ~/.claude/skills/ (personal-claude) │ + │ 8. PLUGIN: skills/ dirs (plugin) │ + │ 9. COPILOT_SKILLS_DIRS env + config (custom) │ │ --- then commands (.claude/commands/), skills override commands ---│ └──────────────────────┬──────────────────────────────────────────────┘ │ From 954202bae89cbfa340614378483a7908b5b9422b Mon Sep 17 00:00:00 2001 From: Lewis Llobera <35342598+lewislbr@users.noreply.github.com> Date: Thu, 19 Mar 2026 12:46:23 +0100 Subject: [PATCH 4/6] Add alternative personal skills directory for agents --- .../reference/copilot-cli-reference/cli-command-reference.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/copilot/reference/copilot-cli-reference/cli-command-reference.md b/content/copilot/reference/copilot-cli-reference/cli-command-reference.md index 95eb5d9a72d0..37907dabd003 100644 --- a/content/copilot/reference/copilot-cli-reference/cli-command-reference.md +++ b/content/copilot/reference/copilot-cli-reference/cli-command-reference.md @@ -479,6 +479,7 @@ Skills are loaded from these locations in priority order (first found wins for d | `.claude/skills/` | Project | Claude-compatible location. | | Parent `.github/skills/` | Inherited | Monorepo parent directory support. | | `~/.copilot/skills/` | Personal | Personal skills for all projects. | +| `~/.agents/skills/` | Personal | Alternative personal location. | | `~/.claude/skills/` | Personal | Claude-compatible personal location. | | Plugin directories | Plugin | Skills from installed plugins. | | `COPILOT_SKILLS_DIRS` | Custom | Additional directories (comma-separated). | From 77ad43b325f1abe2158b72a1b397fb7d01bfc77f Mon Sep 17 00:00:00 2001 From: Lewis Llobera <35342598+lewislbr@users.noreply.github.com> Date: Thu, 19 Mar 2026 12:48:26 +0100 Subject: [PATCH 5/6] Fix order of skill storage locations in documentation --- content/copilot/concepts/agents/about-agent-skills.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/copilot/concepts/agents/about-agent-skills.md b/content/copilot/concepts/agents/about-agent-skills.md index 762ae91c1bde..2e697ff99a23 100644 --- a/content/copilot/concepts/agents/about-agent-skills.md +++ b/content/copilot/concepts/agents/about-agent-skills.md @@ -22,8 +22,8 @@ You can create your own skills to teach {% data variables.product.prodname_copil {% data variables.product.prodname_copilot_short %} supports: -* Project skills, stored in your repository (`.agents/skills`, `.github/skills` or `.claude/skills`) -* Personal skills, stored in your home directory and shared across projects (`~/.agents/skills`, `~/.copilot/skills` or `~/.claude/skills`) ({% data variables.copilot.copilot_coding_agent %} and {% data variables.copilot.copilot_cli %} only) +* Project skills, stored in your repository (`.github/skills`, `.agents/skills` or `.claude/skills`) +* Personal skills, stored in your home directory and shared across projects (`~/.copilot/skills`, `~/.agents/skills` or `~/.claude/skills`) ({% data variables.copilot.copilot_coding_agent %} and {% data variables.copilot.copilot_cli %} only) Support for organization-level and enterprise-level skills is coming soon. From 2629d0bc7a12c2f5d8aeafb0c7400fb264be3b5d Mon Sep 17 00:00:00 2001 From: Lewis Llobera <35342598+lewislbr@users.noreply.github.com> Date: Thu, 19 Mar 2026 12:49:37 +0100 Subject: [PATCH 6/6] Reorder storage locations for skills in documentation --- data/reusables/copilot/creating-adding-skills.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/data/reusables/copilot/creating-adding-skills.md b/data/reusables/copilot/creating-adding-skills.md index 8315759ca2b3..dffe917103b9 100644 --- a/data/reusables/copilot/creating-adding-skills.md +++ b/data/reusables/copilot/creating-adding-skills.md @@ -6,9 +6,9 @@ To add a skill, you save the `SKILL.md` file, and any subsidiary resources, to a 1. Create a `skills` directory to store your skill and any others you may want to create in the future. - For **project skills**, specific to a single repository, store your skill under `.agents/skills`, `.github/skills` or `.claude/skills`. + For **project skills**, specific to a single repository, store your skill under `.github/skills`, `.agents/skills` or `.claude/skills`. - For **personal skills**, shared across projects, store your skill under `~/.agents/skills`, `~/.copilot/skills` or `~/.claude/skills`. + For **personal skills**, shared across projects, store your skill under `~/.copilot/skills`, `~/.agents/skills` or `~/.claude/skills`. 1. Create a subdirectory for your new skill. Each skill should have its own directory (for example, `.github/skills/webapp-testing`).