Microsoft added SKILL.md support to VS Code in April 2026 through GitHub Copilot's agent mode. If you use VS Code with Copilot, you can now install the same SKILL.md skills that work in Claude Code, Cursor, and Codex CLI. Here's how to set it up and get the most out of this powerful integration.
How Does VS Code Support SKILL.md?
VS Code itself doesn't natively read SKILL.md files. Instead, the support comes through GitHub Copilot's agent mode, which Microsoft enhanced with SKILL.md compatibility in April 2026. When you use Copilot Chat in agent mode—such as with `@workspace` commands or slash commands—Copilot detects installed SKILL.md skills and uses their instructions to answer your coding queries more accurately and contextually.What Is SKILL.md?
Before diving into setup, it's important to understand what SKILL.md files are. These markdown files define custom AI skills or behaviors that tell the Copilot AI how to respond to specific programming tasks. They act like plug-ins or extensions that teach the AI to perform specialized functions, such as generating boilerplate code, following a coding style guide, or integrating with particular APIs.Where Do Skills Go in VS Code?
There are two main locations where you can place SKILL.md files for Copilot to detect:1. Project-specific skills: Place SKILL.md files in your project under the `.github/skills/` directory. This allows skills to be scoped only to that repository.
2. Global skills: Store SKILL.md files in the global directory `~/.config/github-copilot/skills/` (on Linux/macOS) or `%APPDATA%\GitHub\copilot\skills\` (on Windows). These skills are available across all projects for your user account.
Copilot's agent mode automatically scans these directories and loads the relevant skills based on your current context and commands.
Step-by-Step Setup Guide
Follow these numbered steps to install and use SKILL.md skills in your VS Code environment:1. Ensure you have an active GitHub Copilot subscription that supports agent mode (Individual, Business, or Enterprise). 2. Install or update VS Code to the latest version supporting Copilot agent mode (April 2026 or later). 3. Install the GitHub Copilot extension for VS Code if you haven’t already. 4. Activate Copilot Chat and agent mode inside VS Code. You can do this by opening the Copilot Chat panel and ensuring the agent mode toggle is enabled. 5. Create your SKILL.md files either locally in `.github/skills/` inside your repo or globally in your config directory. 6. Restart VS Code to ensure Copilot detects the new skills. 7. Use Copilot Chat with `@workspace` or slash commands to invoke your skills. For example, typing `@workspace generate test cases` triggers the matching SKILL.md skill.
With these steps, your custom skills are ready to supercharge your coding workflow in VS Code.
Practical Example: Adding a Skill to Generate Unit Tests
Let’s say you want to create a skill that automatically generates unit tests for JavaScript functions. Here’s a simple SKILL.md you could use:```markdown
Generate Unit Tests
When the user requests "generate unit tests" or "create test cases", respond by creating Jest test functions covering all exported functions in the current file. ```Place this SKILL.md in `.github/skills/` inside your project. Now, inside VS Code, open Copilot Chat and type:
`@workspace generate unit tests`
Copilot will respond by generating Jest test boilerplate code for your exported functions, saving you time writing repetitive tests manually.
Tips for Managing SKILL.md Skills
- Use descriptive names and clear instructions inside SKILL.md files to help Copilot match user prompts accurately. - Version control your skills by committing them to your repository’s `.github/skills/` folder so your team can share and update skills collaboratively. - Test skills locally before sharing globally to ensure they behave as expected. - Organize skills logically by categories or programming languages to keep your skills directory clean and manageable. - Regularly update your Copilot extension and VS Code to benefit from the latest improvements in SKILL.md support.Real-World Use Cases
1. Coding Style Enforcement
Create SKILL.md files that instruct Copilot to write code following your team's style guide, such as enforcing specific indentation, variable naming conventions, or comment formats.2. API Integration Helpers
Develop skills that generate boilerplate code for common API interactions, like fetching data from REST endpoints or authenticating via OAuth.3. Documentation Generation
Define skills to automatically generate function or class documentation based on code comments or definitions.4. Bug Fix Suggestions
Craft skills that analyze code snippets and suggest common bug fixes or improvements, speeding up code reviews and debugging.5. Multi-language Support
Maintain multiple SKILL.md files tailored to different programming languages, enabling Copilot to switch behavior dynamically based on the current file type.Common Issues and How to Fix Them
- Copilot doesn’t detect your SKILL.md files: Ensure files are in the correct directory (`.github/skills/` or the global config folder) and that you have restarted VS Code after adding them. - Agent mode not enabled: Confirm that you are using a Copilot subscription tier that supports agent mode and that it’s activated in the VS Code extension settings. - Skills not triggering on expected prompts: Refine your SKILL.md instructions for clarity and consider adding multiple trigger phrases. - Conflicts between multiple skills: Try disabling or temporarily moving conflicting skills to isolate the issue.The Difference from Claude Code and Cursor
While SKILL.md skills originated with platforms like Claude Code and Cursor, Microsoft’s integration in VS Code via Copilot agent mode offers a seamless developer experience right inside your primary IDE. You don’t need separate CLI tools or online platforms; everything works natively in your editor. Furthermore, VS Code’s rich UI and Copilot Chat allow for interactive skill invocation, context awareness, and instant feedback, making SKILL.md skills more dynamic and accessible.Final Thoughts
SKILL.md support in VS Code through GitHub Copilot agent mode is a game-changer for developers looking to customize their AI coding assistant. By defining and installing your own skills, you can tailor Copilot’s behavior to fit your project’s unique needs, automate repetitive tasks, and boost productivity. With this 2026 setup guide, you now have a clear path to harnessing the full power of SKILL.md skills in your everyday coding workflow. Happy coding!Frequently Asked Questions
What AI tools do developers use most in 2026? Claude Code, GitHub Copilot, and Cursor AI dominate developer workflows. See our Developer Prompts collection.Are AI coding tools worth it? Yes — developers consistently report 20–40% productivity gains on repetitive tasks. Most subscriptions pay for themselves within the first week.
Copilot vs Cursor — which is better? Cursor handles complex multi-file edits better. Copilot integrates into more editors. Most developers who try Cursor prefer it for complex projects.
Is AI-generated code production-ready? AI produces solid starting points, not final code. Always review, test, and refine AI-generated code before deploying to production.
