copilot-compatibility-checker

name	copilot-compatibility-checker
description	Check VS Code and GitHub Copilot feature compatibility. Use this skill when diagnosing why a feature isn't working, checking required settings, or verifying version requirements for experimental features.

Compatibility Checker

This skill helps diagnose and verify VS Code / GitHub Copilot feature compatibility based on version and settings.

When to use this skill

• User reports a feature isn't working
• Setting up experimental/preview features
• Checking if a feature is available in the user's VS Code version
• Diagnosing missing capabilities

Reference Sources

When diagnosing issues, consult these sources for the latest information:

VS Code Release Notes

• VS Code 1.108 Release Notes
• VS Code 1.107 Release Notes
• VS Code 1.106 Release Notes
• VS Code 1.105 Release Notes
• VS Code 1.104 Release Notes
• VS Code 1.103 Release Notes
• VS Code 1.102 Release Notes
• VS Code 1.99 Release Notes
• VS Code 1.95 Release Notes
• All VS Code Updates

Copilot Customization Documentation

• Customization Overview
• Custom Instructions
• Custom Agents
• Prompt Files
• Agent Skills
• MCP Servers
• Language Models

Agents Documentation

• Agents Overview
• Background Agents
• Cloud Agents

Chat & Tools Documentation

• Chat Tools
• Chat Sessions
• Copilot Chat Context

Security & Troubleshooting

• Security Considerations
• Copilot Issues Wiki
• VS Code Settings Reference

GitHub Copilot Documentation

• GitHub Copilot Docs
• Custom Agents (GitHub)
• Coding Agent

Community Resources

• Awesome Copilot Repository
• Agent Skills Standard
• Anthropic Skills Repository

Feature Compatibility Matrix

Custom Instructions

Feature	Setting	Since Version	Status
.github/copilot-instructions.md	github.copilot.chat.codeGeneration.useInstructionFiles	1.95	Stable
*.instructions.md files	Auto-discovered in .github/instructions/	1.99	Stable
AGENTS.md (root)	chat.useAgentsMdFile	1.102	Stable
AGENTS.md (nested/subfolders)	chat.useNestedAgentsMdFiles	1.105	Experimental

Custom Agents

Feature	Setting	Since Version	Status
Custom agents (.agent.md)	Auto-discovered	1.106	Stable
Legacy chat modes (.chatmode.md)	Auto-discovered (deprecated)	1.99-1.105	Deprecated
Subagents with custom agents	chat.customAgentInSubagent.enabled	1.106	Experimental
Organization/Enterprise agents	github.copilot.chat.customAgents.showOrganizationAndEnterpriseAgents	1.107	Experimental

Agent Skills

Feature	Setting	Since Version	Status
Agent Skills	chat.useAgentSkills	1.108	Preview
Project skills (.github/skills/)	chat.useAgentSkills	1.108	Preview
Personal skills (~/.copilot/skills/)	chat.useAgentSkills	1.108	Preview
Legacy skill locations (.claude/skills/)	chat.useAgentSkills	1.108	Preview

Prompt Files

Feature	Setting	Since Version	Status
Prompt files (.prompt.md)	Auto-discovered in .github/prompts/	1.99	Stable
Prompt recommendations	chat.promptFilesRecommendations	1.105	Stable

Tools & Automation

Feature	Setting	Since Version	Status
Terminal tool auto-approval	chat.tools.autoApprove	1.103	Stable
MCP servers	chat.mcp.enabled	1.102	Stable
Background agents	chat.agent.background.enabled	1.107	Experimental

Diagnostic Steps

Step 1: Check VS Code Version

Ask the user to run:

code --version

Or check via: Help → About (macOS: Code → About Visual Studio Code)

The first line is the version number (e.g., 1.108.0).

Step 2: Check Settings

To verify a setting is enabled, check:

1. User settings: ~/.config/Code/User/settings.json (Linux), ~/Library/Application Support/Code/User/settings.json (macOS), %APPDATA%\Code\User\settings.json (Windows)
2. Workspace settings: .vscode/settings.json

Or use the Command Palette: Preferences: Open Settings (JSON)

Step 3: Verify Feature Files

Check if the required files exist in the correct locations:

Feature	Expected Location
Workspace instructions	.github/copilot-instructions.md
Scoped instructions	.github/instructions/*.instructions.md
Custom agents	.github/agents/*.agent.md
Prompt files	.github/prompts/*.prompt.md
Agent Skills	.github/skills/*/SKILL.md
AGENTS.md	Root or subfolders

Common Issues

"My instructions aren't being applied"

1. Check github.copilot.chat.codeGeneration.useInstructionFiles is true
2. Verify file is in correct location
3. For *.instructions.md: check applyTo glob matches target files
4. Check the References section in chat response to see which files were used

"My custom agent doesn't appear"

1. Verify file has .agent.md extension
2. Check file is in .github/agents/ directory
3. Ensure YAML frontmatter is valid (check for syntax errors)
4. Look for the agent in Configure Custom Agents menu

"Agent Skills aren't loading"

1. Enable chat.useAgentSkills setting (it's preview, not on by default)
2. Verify SKILL.md exists in the skill directory
3. Check skill has valid YAML frontmatter with name and description

"Nested AGENTS.md not working"

1. Enable chat.useNestedAgentsMdFiles (experimental)
2. Ensure chat.useAgentsMdFile is also enabled
3. Verify AGENTS.md files are in subfolders (not just root)

"Subagent can't use my custom agent"

1. Enable chat.customAgentInSubagent.enabled (experimental)
2. Verify the custom agent has infer: true (or omitted, as true is default)
3. Ensure runSubagent tool is available

Settings Quick Reference

Enable all experimental features:

{
  "github.copilot.chat.codeGeneration.useInstructionFiles": true,
  "chat.useAgentsMdFile": true,
  "chat.useNestedAgentsMdFiles": true,
  "chat.useAgentSkills": true,
  "chat.customAgentInSubagent.enabled": true,
  "chat.mcp.enabled": true,
  "github.copilot.chat.customAgents.showOrganizationAndEnterpriseAgents": true
}

Version History Reference

Version	Key Features Added
1.108	Agent Skills (preview)
1.107	Background agents (experimental), org/enterprise agents
1.106	Custom agents (renamed from chat modes)
1.105	Nested AGENTS.md (experimental)
1.103	Terminal auto-approval
1.102	MCP servers, AGENTS.md
1.99	Prompt files, instructions files
1.95	copilot-instructions.md

Usage

When a user reports a feature not working or asks about compatibility:

1. Check their VS Code version - Ask them to run code --version or check Help → About
2. Verify required settings - Use the settings quick reference above to identify which experimental flags need to be enabled
3. Check feature availability - Cross-reference with the version history to see if the feature exists in their version
4. Provide solution - Guide them to either update VS Code or enable the necessary settings

Examples

Example 1: Agent Skills not working

• Check: VS Code version ≥ 1.108
• Setting: "chat.useAgentSkills": true
• Solution: Update to 1.108+ and enable the setting

Example 2: Custom agents not appearing

• Check: VS Code version ≥ 1.106
• Setting: "chat.useAgentsMdFile": true
• File: .github/AGENTS.md or .github/agents/*.agent.md exists
• Solution: Verify setting is enabled and file structure is correct