Skip to content

GitHub Copilot support details

Native project prompts, skill-backed user prompts, hooks, and repo-root MCP config.

Copilot keeps most features native, but its repo instruction surfaces differ from other editors.

Start on the full support matrix when you need to compare every editor at once. Use this page when you want the exact terms, support details, and project/user targets for GitHub Copilot.

Related aix concepts: rules , prompts , mcp , skills , hooks .

Editor-specific notes

  • aix writes project MCP config to .mcp.json and still imports .github/mcp.json as a fallback.
  • Project Copilot prompt installs use explicit frontmatter so slash commands keep the configured prompt name.
  • User-scope Copilot prompt installs are converted into native skills under ~/.config/github-copilot/skills/.

Feature details

How to read the statuses

Support key

Editor support

  • Supported The editor exposes that feature at that scope.
  • No support The editor does not expose that feature at that scope.

aix support

  • Native aix writes the editor's own format.
  • Adapter aix keeps the feature through an adapter or alternate representation.
  • No support aix does not write that feature for the destination today.

Use the Project scope and User scope rows to see where config lands at each level.

Rules Learn the concept

Markdown instruction files in .github/instructions/.

GitHub Copilot calls this Instructions
aix support Native
Project
Editor Supported aix Native
Path .github/instructions/*.instructions.md
User
Editor Supported aix No support
Editor target ~/.config/github-copilot/instructions/*.instructions.md
aix: aix does not yet write user-scope Copilot instructions as separate files.

Prompts Learn the concept

Markdown prompt files with YAML frontmatter.

GitHub Copilot calls this Prompt files
aix support Native
Project
Editor Supported aix Native
Path .github/prompts/*.prompt.md
User
Editor Supported aix Adapter
Path ~/.config/github-copilot/skills/{name}/
aix: aix converts user-scope prompts into instruction-only Copilot skills.

Supported metadata: name , description , argument-hint

MCP Learn the concept

JSON mcpServers configuration.

GitHub Copilot calls this MCP servers
aix support Native
Project
Editor Supported aix Native
Path .mcp.json
User
Editor Supported aix Native
Path ~/.config/github-copilot/mcp-config.json
  • Imports also fall back to .github/mcp.json when .mcp.json is absent.

Skills Learn the concept

Symlinked native skill directories backed by .aix/skills/.

GitHub Copilot calls this Skills
aix support Native
Project
Editor Supported aix Native
Path .github/skills/{name}/
User
Editor Supported aix Native
Path ~/.config/github-copilot/skills/{name}/
  • Copilot also discovers .agents/skills/ as a compatibility surface.

Agents

Markdown custom agent files with YAML frontmatter.

GitHub Copilot calls this Agents
aix support Native
Project
Editor Supported aix Native
Path .github/agents/*.md
User
Editor Supported aix Native
Path ~/.config/github-copilot/agents/*.md

Supported metadata: description , mode , model , tools , permissions , mcp-servers , editor.copilot

Hooks Learn the concept

JSON hooks with version: 1, matcher-based tool routing, and cross-platform bash / powershell fields.

GitHub Copilot calls this Hooks
aix support Native
Project
Editor Supported aix Native
Path .github/hooks/hooks.json
User
Editor Supported aix Native
Path ~/.config/github-copilot/hooks/hooks.json

Supported metadata: agentStop , errorOccurred , notification , permissionRequest , postToolUse , postToolUseFailure , preCompact , preToolUse , sessionEnd , sessionStart , subagentStart , subagentStop , userPromptSubmitted

  • Each command hook surfaces bash, powershell, cwd, env, and timeoutSec natively.
  • type: "prompt" is supported on sessionStart only.

AGENTS.md

Compatibility with repository AGENTS.md instructions.

GitHub Copilot calls this AGENTS.md
aix support Native
Project
Editor Supported aix Native
Path AGENTS.md in the repository tree
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: Copilot does not expose a dedicated home-scoped AGENTS.md target in aix.

.agents/skills

Compatibility with the shared Agent Skills folder convention.

GitHub Copilot calls this .agents/skills
aix support Native
Project
Editor Supported aix Native
Path .agents/skills/{name}/
User
Editor Supported aix Native
Path ~/.agents/skills/{name}/

Related guides