Customize AI in Visual Studio Code

Visual Studio Code gives you several ways to teach the AI about your codebase, coding standards, and workflows. This article introduces the customization options and helps you get started.

To access customizations, select the Configure Chat (gear icon) in the Chat view.

Customization scenarios

The following sections describe common customization scenarios and which options to use for each one.

Define coding standards

Use custom instructions to share project-wide rules and conventions with the AI. Always-on instructions apply to every request, while file-based instructions target specific file types or folders. For example, enforce ESLint rules across all files and apply React patterns only in .tsx files.

Automate tasks and workflows

Create prompt files for repeatable tasks you run often, like scaffolding a component or preparing a pull request.

For more complex multi-step workflows that involve scripts and external tools, package them as agent skills.

Specialize the AI

Create custom agents that adopt specific personas, such as security reviewer, database admin, or planner. Each agent defines its own behavior, available tools, and language model preferences. Choose different language models for different tasks, or bring your own API key to access additional models.

Discover and install plugins

Install agent plugins (preview) to add pre-packaged bundles of customizations from plugin marketplaces. A single plugin can provide slash commands, skills, custom agents, hooks, and MCP servers.

Connect external tools and data

Add MCP servers to give the AI access to databases, APIs, and other services through the Model Context Protocol. Use hooks to run shell commands at key lifecycle points, such as running a formatter after every file edit or enforcing security policies.

Get started

Implement AI customizations incrementally. Start with the basics and add more as needed. For a hands-on walkthrough, see the Customize AI for your project guide.

1. Initialize your project: type /init in chat to generate a .github/copilot-instructions.md file with coding standards tailored to your codebase.

2. Add targeted rules: create file-based *.instructions.md files for specific parts of your codebase, such as language conventions or framework patterns.

3. Automate repetitive tasks: create prompt files for common workflows and add MCP servers to connect external services.

4. Create specialized workflows: build custom agents for specific roles. Package reusable capabilities as agent skills to share across tools.

5. Generate customizations with AI: type /create-prompt, /create-instruction, /create-skill, /create-agent, or /create-hook in chat to generate customization files with AI assistance.

Chat Customizations editor

The Chat Customizations editor provides a centralized UI for discovering, creating, and managing all your customizations in one place. From the editor, you can browse customization categories (agents, skills, instructions, prompts, hooks, MCP servers), create new items with optional AI-guided generation, and edit existing customizations in an embedded code editor.

To open the Chat Customizations editor, run Chat: Open Chat Customizations from the Command Palette (⇧⌘P (Windows, Linux Ctrl+Shift+P)).

Troubleshoot customization issues

If your customizations aren't being applied or cause unexpected behavior, select Configure Chat (gear icon) > Show Agent Logs in the Chat view to troubleshoot agent issues.

Related resources

• Customization concepts
• Customize AI for your project guide