Add .agents/skills skill storage paths in documentation#43439
Add .agents/skills skill storage paths in documentation#43439lewislbr wants to merge 6 commits intogithub:mainfrom
Conversation
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.
How to review these changes 👓Thank you for your contribution. To review these changes, choose one of the following options: A Hubber will need to deploy your changes internally to review. Table of review linksNote: Please update the URL for your staging server or codespace. The table shows the files in the Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server 🤖 This comment is automatically generated. |
There was a problem hiding this comment.
Pull request overview
Updates Copilot agent-skills documentation to include the cross-client .agents/skills convention for storing skills, aiming to improve interoperability across tools that implement the Agent Skills standard.
Changes:
- Add
.agents/skillsas an additional project skill directory in the “creating skills” reusable and the conceptual overview. - Add
~/.agents/skillsas an additional personal skill directory in Copilot CLI reference docs and the conceptual overview. - Update the Copilot CLI plugin loading-order diagram to include
~/.agents/skillsin the precedence list.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 4 comments.
| File | Description |
|---|---|
| data/reusables/copilot/creating-adding-skills.md | Adds .agents/skills and ~/.agents/skills to the reusable instructions for where to store skills. |
| content/copilot/reference/copilot-cli-reference/cli-plugin-reference.md | Updates the skills loading-order diagram to include ~/.agents/skills. |
| content/copilot/reference/copilot-cli-reference/cli-command-reference.md | Adds ~/.agents/skills/ to the “Skill locations” table. |
| content/copilot/concepts/agents/about-agent-skills.md | Expands the overview list of supported skill locations to include .agents/skills and ~/.agents/skills. |
You can also share your feedback on Copilot code review. Take the survey.
| │ 6. ~/.claude/skills/ (personal-claude) │ | ||
| │ 7. PLUGIN: skills/ dirs (plugin) │ | ||
| │ 8. COPILOT_SKILLS_DIRS env + config (custom) │ | ||
| │ 6. ~/.agents/skills/ (personal-skills) │ |
| | `.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. | |
| * 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) |
| 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`. |
Why:
As stated in stated in https://agentskills.io/client-implementation/adding-skills-support#where-to-scan, the
.agents/skillspaths are a convention for cross-client skill sharing.These paths are already supported by VSCode Chat: https://code.visualstudio.com/docs/copilot/customization/agent-skills#_create-a-skill, and there seems to be a bug in the Copilot CLI github/copilot-cli#2161 that makes them partially supported.
What's being changed (if available, include any code snippets, screenshots, or gifs):
Added the
.agents/skillsproject and personal paths.Check off the following: