Copilot Compatibility Checker

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

Custom Agents

Agent Skills

Prompt Files

Tools & Automation

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:

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

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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.