Use Agent Skills in VS Code
AI agents: See llms.txt for documentation discovery and navigation. Documentation articles are also available as Markdown by appending .md to the article URL. 🎬 Watch The Story of VS Code! VS Code is now on Instagram, follow @vscode.ig for updates, tips, and more. Rewatch GitHub Copilot Day. Use Agent Skills in VS Code View as Markdown Ask in VS Code Ask in VS Code Insiders Agent Skills are folders of instructions, scripts, and resources that AI agents can load when relevant to perform specialized tasks.
Agent Skills is an open standard that works across multiple AI agents, including GitHub Copilot in VS Code, GitHub Copilot CLI, the GitHub Copilot app, Copilot cloud agent, and OpenAI Codex through Agent Host (Experimental). Unlike custom instructions that primarily define coding guidelines, skills enable specialized capabilities and workflows that can include scripts, examples, and other resources. Skills you create are portable across skills-compatible agents, but supported locations and optional features vary by agent.
Unless otherwise noted, the configuration options and controls on this page apply to Copilot. For how skills compare with the other customization options, see Customization concepts . Key benefits of Agent Skills: Specialize Copilot : Tailor capabilities for domain-specific tasks without repeating context Reduce repetition : Create once, use automatically across all conversations Compose capabilities : Combine multiple skills to build complex workflows Efficient loading : Only relevant content loads into context when needed Tip Use the Agent Customizations editor (Preview) to discover, create, and manage all your agent customizations in one place.
Run Chat: Open Customizations from the Command Palette. Agent Skills vs custom instructions While both Agent Skills and custom instructions help customize Copilot's behavior, they serve different purposes: Feature Agent Skills Custom Instructions Purpose Teach specialized capabilities and workflows Define coding standards and guidelines Portability Works across VS Code, Copilot CLI, the GitHub Copilot app, Copilot cloud agent, and OpenAI Codex through Agent Host (Experimental) Reusable across experiences that support the selected instruction format Content Instructions, scripts, examples, and resources Instructions only Scope Task-specific, loaded on-demand Always applied (or via glob patterns) Standard Open standard ( agentskills.io ) Multiple formats, such as AGENTS.md and .github/copilot-instructions.md For example, you can share a repository's .github/copilot-instructions.md between VS Code and GitHub Copilot CLI .
Check the supported file locations and activation rules for each experience. Use Agent Skills when you want to: Create reusable capabilities that work across different AI tools Include scripts, examples, or other resources alongside instructions Share capabilities with the wider AI community Define specialized workflows like testing, debugging, or deployment processes Use custom instructions when you want to: Define project-specific coding standards Set language or framework conventions Specify code review or commit message guidelines Apply rules based on file types using glob patterns Create a skill Tip Type /skills in the chat input to quickly open the Configure Skills menu.
Skills are stored in directories with a SKILL.md file that defines the skill's behavior. VS Code supports two types of skills: Skill type Location Project skills, stored in your repository .github/skills/ , .claude/skills/ , .agents/skills/ Personal skills, stored in your user profile ~/.copilot/skills/ , ~/.claude/skills/ , ~/.agents/skills/ Note To reuse repository skills with OpenAI Codex, set up Codex on Agent Host (Experimental).
This integration discovers workspace skills in .github/skills/ before your first prompt, without additional skill-location configuration. Codex also discovers .agents/skills/ natively. If skills in .github/skills/ have duplicate names across workspace roots, the primary root takes precedence. Discovery makes skills available to the model but does not guarantee that it invokes a skill for every relevant prompt. Note The chat.agentSkillsLocations Open in VS Code Open in VS Code Insiders setting is deprecated and only used by the Local agent.
If you configured other skill locations with this setting, migrate the skills to supported locations . Tip In a monorepo, enable chat.useCustomizationsInParentRepositories Open in VS Code Open in VS Code Insiders to discover skills from the parent repository root. Learn more about parent repository discovery . To create a skill: In the Chat view, select Configure Chat (gear icon) to open the Agent Customizations editor and then select the Skills tab.
Select New Skill (Workspace) or New Skill (User) from the dropdown, depending on where you want to store the skill. Select the location and enter a name for the skill. Complete the SKILL.md file by filling in the YAML frontmatter and adding instructions in the body of the file. --- name : skill-name description : Description of what the skill does and when to use it --- # Skill Instructions Your detailed instructions, guidelines, and examples go here...
Optionally, add scripts, examples, or other resources to your skill's directory. For example, a skill for testing web applications might include: SKILL.md - Instructions for running tests test-template.js - A template test file examples/ - Example test scenarios Note Make sure to reference any additional files in your SKILL.md for them to be picked up by the agent. Use Markdown links or #file: references with paths relative to the SKILL.md file, such as [test template](./test-template.js) or #file:./test-template.js .
Generate a skill with AI You can use AI to generate a skill based on a description of the capability. Type /create-skill in chat and describe the skill you want (for example, "a skill for running and debugging integration tests"). The agent asks clarifying questions and generates a SKILL.md file with the directory structure, instructions, and frontmatter. You can also extract a reusable skill from an ongoing conversation.
For example, after a multi-turn session where you debugged a complex issue, ask "create a skill from how we just debugged that" to capture the multi-step procedure as a reusable skill. You can also generate a skill from the Agent Customizations editor by selecting Generate Skill from the dropdown. Install a skill from the Customization Marketplace (Experimental) Use the Customization Marketplace to find and install complete skill packages from configured sources: Turn on the chat.customizations.marketplace.enabled Open in VS Code Open in VS Code Insiders setting.
Open the Agent Customizations editor and select Discover . From the source menu, select GitHub Feed , and then search for a skill by name or add @type:skill to your search. Select a skill and review its publisher, source, and included files. Select Install , and then choose the user or workspace skills directory where you want to store the skill. VS Code doesn't overwrite an existing skill at the selected destination.
If another supported location contains a skill with the same name, both skills appear on the Skills page. The source or publisher image identifies the Marketplace installation, and Copy Relative Path shows its exact location. Marketplace ownership applies to the exact installed skill directory. Deleting a Marketplace-installed skill from the Skills page uninstalls only that skill and doesn't remove a same-name local skill in another location.
If files from a Marketplace-installed skill are missing, Discover shows Missing files . Select Repair to restore only the missing packaged files. Files that you changed or added remain unchanged. For more information about browsing sources and installation states, see Discover marketplace customizations . SKILL.md file format The SKILL.md file is a Markdown file with YAML frontmatter that defin
The rest of this page is on the live site.