vs code
    vscode
    github copilot

    How to Use SKILL.md Skills in VS Code (2026 Setup Guide)

    Microsoft added SKILL.md support to VS Code through GitHub Copilot's agent mode. Here's how to install and use skills in VS Code.

    April 28, 20265 min read
    Share:

    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.

    Quick Answer: VS Code reads SKILL.md skills through GitHub Copilot's agent mode. Place your SKILL.md files in .github/skills/ in your project root or in ~/.config/github-copilot/skills/ for global skills. Copilot's agent detects them automatically and loads the right skill based on your request. The same skills that work in Claude Code and Cursor work in VS Code without modification.

    How does VS Code support SKILL.md?

    VS Code doesn't read SKILL.md files natively. The support comes through GitHub Copilot's agent mode, which Microsoft shipped with SKILL.md compatibility in April 2026. When you use Copilot Chat in agent mode (the @workspace or slash commands), Copilot reads installed skills and follows their instructions for matching tasks.

    This means you need an active GitHub Copilot subscription (Individual, Business, or Enterprise) to use SKILL.md skills in VS Code. The free tier of Copilot does not include agent mode.

    Where do skills go in VS Code?

    There are two locations depending on whether you want project-specific or global skills.

    Project-specific skills go in .github/skills/ at the root of your repository. These are version-controlled and shared with your team. Every team member who opens the project gets the same skills automatically.

    your-project/
    ├── .github/
    │   └── skills/
    │       ├── code-reviewer/
    │       │   └── SKILL.md
    │       └── test-generator/
    │           └── SKILL.md
    ├── src/
    └── package.json
    

    Global skills go in your user config directory. On macOS and Linux this is ~/.config/github-copilot/skills/. On Windows it's %APPDATA%\github-copilot\skills\. Global skills are available in every project.

    Using Agensi skills

    Connect your MCP-compatible agent to Agensi, choose a skill and ask the agent to use it on your task. Approve any required purchase. The latest approved instructions load through get_skill on each use. Never write any part of the skill to disk; your licence does not allow you to save, copy or export it.

    Does every SKILL.md work in VS Code?

    The core instructions in any SKILL.md file work across VS Code, Claude Code, Cursor, Codex CLI, and every other agent that supports the format. The instructions are plain English markdown, so there's nothing agent-specific about them.

    However, some skills use agent-specific metadata fields in their YAML frontmatter. Fields like context: fork (Claude Code) or agent-specific globs patterns may be ignored by Copilot. The instructions themselves still work, only the metadata differs.

    Skills on Agensi show a compatibility badge indicating which agents they've been tested with. Look for the VS Code or GitHub Copilot badge when browsing.

    How do I use a skill once it's installed?

    Open Copilot Chat in VS Code (Cmd+I or Ctrl+I). Ask it to do something that matches the skill's description. For example, if you installed a code review skill, ask "review this file for security issues" and Copilot will load and follow the skill's instructions.

    You don't need to explicitly reference the skill name. Copilot reads all installed skill descriptions and picks the most relevant one based on what you ask. This works the same way skill selection works in Claude Code and Cursor.

    VS Code vs Cursor for SKILL.md skills

    Both VS Code (with Copilot) and Cursor support SKILL.md, but there are differences.

    Cursor has had SKILL.md support longer and also supports .cursorrules for always-on project context. VS Code relies entirely on Copilot's agent mode for skill loading. Cursor's skill detection tends to be faster because it's more deeply integrated into the editor.

    For a detailed comparison, read Cursor Rules vs SKILL.md.

    If you're choosing between the two, the SKILL.md files you build will work in both. You're not locked into either editor.


    Browse security-scanned skills for VS Code and every other agent at agensi.io/skills.

    Frequently Asked Questions

    VS Code supports SKILL.md files through GitHub Copilot's agent mode, which was enabled in April 2026. Copilot Chat uses installed skills to follow instructions for matching tasks.

    To use SKILL.md skills in VS Code, you need an active GitHub Copilot subscription (Individual, Business, or Enterprise). The free tier of Copilot does not include the necessary agent mode.

    For project-specific skills, place SKILL.md files in the `.github/skills/` directory at the root of your repository. These skills are version-controlled and shared with team members.

    Global SKILL.md skills are stored in your user configuration directory, specifically `~/.config/github-copilot/skills/` on macOS and Linux, and `%APPDATA%\github-copilot\skills\` on Windows.

    To install a skill, download it and unzip its contents into the appropriate project-specific or global skills directory, ensuring the SKILL.md file is at the root of the skill folder. Afterward, restart VS Code or reload the window for Copilot to detect the new skill.

    To activate a skill, open Copilot Chat (Cmd+I or Ctrl+I) and ask it to perform a task that aligns with the skill's description. Copilot will automatically identify and use the relevant installed skill without needing explicit referencing.

    The core instructions in SKILL.md files work universally across various agents like VS Code, Claude Code, and Cursor. However, agent-specific metadata fields in the YAML frontmatter, such as `context: fork` or specific `globs` patterns, might be ignored by Copilot.