Add .agents/skills skill storage paths in documentation by lewislbr · Pull Request #43439 · github/docs

lewislbr · 2026-03-19T09:53:17Z

Why:

As stated in stated in https://agentskills.io/client-implementation/adding-skills-support#where-to-scan, the .agents/skills paths 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 a bug in the Copilot CLI github/copilot-cli#2161 that made them partially supported has been resolved.

What's being changed (if available, include any code snippets, screenshots, or gifs):

Added the .agents/skills project and personal paths.

Check off the following:

A subject matter expert (SME) has reviewed the technical accuracy of the content in this PR. In most cases, the author can be the SME. Open source contributions may require an SME review from GitHub staff.
The changes in this PR meet the docs fundamentals that are required for all content.
All CI checks are passing and the changes look good in the review environment.

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.

github-actions · 2026-03-19T09:53:47Z

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 links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source	Review	Production	What Changed
`copilot/concepts/agents/about-agent-skills.md`	fpt ghec	fpt ghec
`copilot/reference/copilot-cli-reference/cli-command-reference.md`	fpt ghec	fpt ghec
`copilot/reference/copilot-cli-reference/cli-plugin-reference.md`	fpt ghec	fpt ghec
`copilot/how-tos/copilot-cli/customize-copilot/create-skills.md`	fpt ghec	fpt ghec	from reusable
`copilot/how-tos/use-copilot-agents/coding-agent/create-skills.md`	fpt ghec	fpt ghec	from reusable

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

Copilot

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/skills as an additional project skill directory in the “creating skills” reusable and the conceptual overview.
Add ~/.agents/skills as 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/skills in 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)              │


ryancampbellriddle-source · 2026-08-15T01:08:27Z

 | `.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`.


Sharra-writes · 2026-03-20T17:29:35Z

@lewislbr I'm already looking into this for another PR, although I think this one is more comprehensive than that one if I do get approval for adding it to the docs. If it's only partially/accidentally supported, though, I'm not sure I'm going to get approval. We'll see.

lewislbr · 2026-03-21T08:46:09Z

Thanks @Sharra-writes, this PR is conditional on github/copilot-cli#2161 being addressed

lewislbr · 2026-03-24T09:30:41Z

~/.agents/skills is now supported in the 1.0.11 release: Add ~/.agents/skills/ as a personal skill discovery directory, aligning with VS Code's GHCP4A extension default

github-actions · 2026-05-11T17:11:21Z

A stale label has been added to this pull request because it has been open 30 days with no activity. If you think this pull request should remain open, please add a new comment.

github-actions · 2026-07-13T17:03:22Z

A stale label has been added to this pull request because it has been open 30 days with no activity. If you think this pull request should remain open, please add a new comment.

subatoi · 2026-08-20T12:43:15Z

@lewislbr Hello, and thank you for raising this. I apologise it's taken so long to bring this to a conclusion but as you may have noted, this information has been added to the docs since you originally raised this PR. As such, I'm going to close this out. Thank you again, and apologies again that this wouldn't have been the answer you were looking for 🙇

ryancampbellriddle-source

Thanks!!!

Add .agents/skills skill storage paths in documentation

57c99e0

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.

github-actions Bot added the triage Do not begin working on this issue until triaged by the team label Mar 19, 2026

lewislbr added 5 commits March 19, 2026 10:58

Add .agents/skills skill storage paths in documentation

095cdd3

Add .agents/skills skill storage paths in documentation

33441d7

Add alternative personal skills directory for agents

954202b

Fix order of skill storage locations in documentation

77ad43b

Reorder storage locations for skills in documentation

2629d0b

lewislbr marked this pull request as ready for review March 19, 2026 11:50

Copilot AI review requested due to automatic review settings March 19, 2026 11:50

Copilot AI reviewed Mar 19, 2026

View reviewed changes

This comment was marked as spam.

Sign in to view

novam9704-collab mentioned this pull request Mar 23, 2026

## Pull request overview novam9704-collab/Milton#3

Open

github deleted a comment from paisannick99-create Mar 25, 2026

Sharra-writes added content This issue or pull request belongs to the Docs Content team copilot Content related to GitHub Copilot and removed triage Do not begin working on this issue until triaged by the team labels Mar 25, 2026

github-actions Bot added the Inactive Will be closed automatically by a stall check if no activity is detected. label May 11, 2026

Sharra-writes removed the Inactive Will be closed automatically by a stall check if no activity is detected. label May 15, 2026

github-actions Bot added the Inactive Will be closed automatically by a stall check if no activity is detected. label Jul 13, 2026

Sharra-writes removed the Inactive Will be closed automatically by a stall check if no activity is detected. label Jul 22, 2026

subatoi closed this Aug 20, 2026

ryancampbellriddle-source reviewed Aug 24, 2026

View reviewed changes

Navigation Menu

Uh oh!

Add .agents/skills skill storage paths in documentation - #43439

Add .agents/skills skill storage paths in documentation#43439
lewislbr wants to merge 6 commits into
github:mainfrom
lewislbr:patch-1

lewislbr commented Mar 19, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Mar 19, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

ryancampbellriddle-source Aug 15, 2026

Uh oh!

Sharra-writes commented Mar 20, 2026

Uh oh!

This comment was marked as spam.

lewislbr commented Mar 21, 2026

Uh oh!

lewislbr commented Mar 24, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented May 11, 2026

Uh oh!

github-actions Bot commented Jul 13, 2026

Uh oh!

subatoi commented Aug 20, 2026

Uh oh!

ryancampbellriddle-source left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Uh oh!

Conversation

lewislbr commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Why:

What's being changed (if available, include any code snippets, screenshots, or gifs):

Check off the following:

Uh oh!

github-actions Bot commented Mar 19, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

How to review these changes 👓

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

ryancampbellriddle-source Aug 15, 2026

Choose a reason for hiding this comment

Uh oh!

Sharra-writes commented Mar 20, 2026

Uh oh!

This comment was marked as spam.

lewislbr commented Mar 21, 2026

Uh oh!

lewislbr commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented May 11, 2026

Uh oh!

github-actions Bot commented Jul 13, 2026

Uh oh!

subatoi commented Aug 20, 2026

Uh oh!

ryancampbellriddle-source left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

lewislbr commented Mar 19, 2026 •

edited

Loading

github-actions Bot commented Mar 19, 2026 •

edited

Loading

lewislbr commented Mar 24, 2026 •

edited

Loading