Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions content/copilot/concepts/agents/about-agent-skills.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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). |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -193,9 +193,10 @@ The following diagram illustrates the loading order and precedence rules.
│ 3. <project>/.claude/skills/ (project) │
│ 4. <parents>/.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 ---│
└──────────────────────┬──────────────────────────────────────────────┘
Expand Down
4 changes: 2 additions & 2 deletions data/reusables/copilot/creating-adding-skills.md
Original file line number Diff line number Diff line change
Expand Up @@ -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`.
Comment on lines +9 to +11

1. Create a subdirectory for your new skill. Each skill should have its own directory (for example, `.github/skills/webapp-testing`).

Expand Down
Loading