Skip to content

Missing Copilot Documentation on allowed-tools Field in Skill Frontmatter #45354

Description

@jpreuschoff

Code of Conduct

What article on docs.github.com is affected?

This would probably best fit into the "Creating and adding a skill" section.

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

I would like configure Copilot using the least-privilege principle, only allowing Copilot to use tools that are required to complete the tasks Copilot is given. I would like to use the allowed-tools field that is part of the Agent Skills Specification in order to do so, but I am missing documentation on how to set that field for copilot. I would like to have additional information on how to set the allowed-tools field, specifically about

  • which formats are valid (i.e. normal YAML syntax, comma-separated line, space-separated line...)
  • which tools are supported
  • how to specify tools provided by an MCP server
  • how to limit which commands Copilot is allowed to execute when using the bash or shell tools

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