> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getgaal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Copilot

> Copilot in VS Code, with MCP via VS Code settings.

[GitHub Copilot](https://docs.github.com/en/copilot) reads agent skills from `.github/skills` and reads MCP server configuration from VS Code's `settings.json`.

## Paths

| Resource | Path |
| - | - |
| Project skills | `.github/skills` |
| Global skills | `~/.copilot/skills` |
| MCP config | `~/.vscode/settings.json` |
| Audit search (project) | `.github/skills`, `.agents/skills`, `.claude/skills` |
| Audit search (global) | `~/.copilot/skills`, `~/.claude/skills`, `~/.agents/skills` |
| Package-manager search | `~/.vscode/agent-plugins` |

See also: [VS Code Copilot agent skills docs](https://code.visualstudio.com/docs/copilot/customization/agent-skills#_create-a-skill).

## Skills example

```yaml gaal.yaml theme={"theme":"nord"}
skills:
  - source: anthropics/skills
    agents: [github-copilot]
    select: [frontend-design]
    global: false      # → .github/skills
```

## MCP example

```yaml gaal.yaml theme={"theme":"nord"}
mcps:
  - name: github
    agents: [github-copilot]
    global: true
    inline:
      command: npx
      args: ["-y", "@modelcontextprotocol/server-github"]
      env:
        GITHUB_PERSONAL_ACCESS_TOKEN: ${GITHUB_TOKEN}
```

gaal upserts under the `mcpServers` key while leaving every other VS Code setting in place.

## Related

> [card] [Configure skills](https://docs.getgaal.com/configure/skills.md)

> [card] [Configure MCP servers](https://docs.getgaal.com/configure/mcp-servers.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.