Awesome/awesome-copilot
1
0
Fork 0
mirror of https://github.com/github/awesome-copilot.git synced 2026-06-19 06:01:27 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: clarify personal skill directories (#2032)

Browse Source 
* docs: clarify personal skill directories

* docs: revert mirrored CLI beginners guide changes
This commit is contained in:
ProfTrader
2026-06-19 05:50:00 +05:30
committed by GitHub
parent 128b0eda41
commit e40c041533
3 changed files with 7 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
instructions/agent-skills.instructions.md
+2 -1
View File
@@ -25,7 +25,8 @@ Skills are stored in specific locations:
|----------|-------|----------------| |----------|-------|----------------|
| `.github/skills/<skill-name>/` | Project/repository | Recommended for project skills | | `.github/skills/<skill-name>/` | Project/repository | Recommended for project skills |
| `.claude/skills/<skill-name>/` | Project/repository | Legacy, for backward compatibility | | `.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 | | `~/.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. Each skill **must** have its own subdirectory containing at minimum a `SKILL.md` file.
skills/cli-mastery/references/module-5-skills.md
+2 -2
View File
@@ -10,13 +10,13 @@
| Level | Location | | 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` | | Repo | `.github/skills/<name>/SKILL.md` |
| Org | Shared via org-level config | | Org | Shared via org-level config |
## Creating a custom skill ## 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`) 2. Create `SKILL.md` with YAML frontmatter (`name`, `description`, optional `tools`)
3. Write detailed instructions for the AI's behavior 3. Write detailed instructions for the AI's behavior
4. Verify with `/skills` 4. Verify with `/skills`
website/src/content/docs/learning-hub/copilot-configuration-basics.md
+3 -3
View File
@@ -194,7 +194,7 @@ When you work inside `packages/api/`, Copilot loads configuration from `packages
### Personal Skills Directory ### 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/ ~/.agents/
@@ -205,7 +205,7 @@ In addition to repository-level skills, GitHub Copilot CLI supports a **personal
└── SKILL.md └── 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 ### 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/`. 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 ### Model Picker