Agent skills directory discoverability sections is missing support for .agents/skills and ~/.agent/skills

[AlahmadiQ8]

Code of Conduct

• I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

The Agent skills directory discoverability section in the documentation does not reflect all supported directory locations.

According to the current docs: https://github.com/github/docs/blob/main/content/copilot/concepts/agents/about-agent-skills.md

Only the following locations are documented:

Project skills

• .github/skills
• .claude/skills

Personal skills

• ~/.copilot/skills
• ~/.claude/skills

However, during testing, I confirmed that the following directories are also supported by Copilot Agents, but are not mentioned anywhere in the documentation:

• .agent/skills
• ~/.agent/skills

These directories were successfully discovered and loaded by Copilot Agents in:

• VS Code (stable)
• VS Code Insiders

What part(s) of the article would you like to see updated?

Creating and adding skills

The documentation should list all supported agent skill discovery paths, including:

• .agent/skills (project-level)
• ~/.agent/skills (user-level)

Additional information

No response

[Sharra-writes]

@AlahmadiQ8 Thanks for opening an issue! I will take this to the Copilot team to see what's going on and whether the docs need to be updated.

[roberthawkins671-pixel]

[AlahmadiQ8]

I think this issue can be closed.

I was using npm skills and apparently it may have automatically updated my vscode setting to add ~/.agent/skills as an additional skills directory.

Apologies for the confusion