diff --git a/content/copilot/concepts/agents/about-agent-skills.md b/content/copilot/concepts/agents/about-agent-skills.md index fa6f689dc765..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 (`.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 (`.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. 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). | 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 ---│ └──────────────────────┬──────────────────────────────────────────────┘ │ diff --git a/data/reusables/copilot/creating-adding-skills.md b/data/reusables/copilot/creating-adding-skills.md index 65a57707d7ad..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 `.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 `~/.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`).