Skip to content

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

@AlahmadiQ8

Description

@AlahmadiQ8

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    contentThis issue or pull request belongs to the Docs Content teamtriageDo not begin working on this issue until triaged by the team

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions