# agent-customization

> Claude/Codex skill by [@microsoft](https://omgskills.com/library/microsoft/index.md) · 194k stars · Updated 2026-10-19

\*\*WORKFLOW SKILL\*\* — Create, update, review, fix, or debug VS Code agent customization files (.instructions.md, .prompt.md, .agent.md, SKILL.md, copilot-instructions.md, AGENTS.md). USE FOR: saving coding preferences; troubleshooting why instructions/skills/agents are ignored or not invoked; configuring applyTo patterns; defining tool restrictions; creating custom agent modes or specialized workflows; packaging domain knowledge; fixing YAML frontmatter syntax. DO NOT USE FOR: general coding questions (use default agent); runtime debugging or error diagnosis; MCP server configuration (use MCP docs directly); VS Code extension development. INVOKES: file system tools (read/write customization files), ask-questions tool (interview user for requirements), subagents for codebase exploration. FOR SINGLE OPERATIONS: For quick YAML frontmatter fixes or creating a single file from a known pattern, edit the file directly — no skill needed.

Tags: editor, electron, microsoft, typescript, visual-studio-code

## Install

```sh
git clone https://github.com/microsoft/vscode /tmp/vscode && ln -s /tmp/vscode/extensions/copilot/assets/prompts/skills/agent-customization ~/.claude/skills/agent-customization
```

## From README

Agent Customization Decision Flow | Primitive | When to Use | |-----------|-------------| | agent instructions | Always-on, applies everywhere in the project | | File Instructions | Explicit via applyTo patterns, or on-demand via description | | MCP | Integrates external systems, APIs, or data | | Hooks | Deterministic shell commands at agent lifecycle points (block tools, auto-format, inject context) | | Custom Agents | Subagents for context isolation, or multi-stage workflows with tool restrictions | | Prompts | Single focused task with parameterized inputs | | Skills | On-demand workflow with bundled assets (scripts/templates) | Quick Reference Consult the reference docs for templates, domain examples, advanced frontmatter options, asset organization, anti-patterns, and creation checklists. If the references are not enough, load the official documentation links for each primitive.

## Links

- HTML page: https://omgskills.com/library/microsoft/vscode/agent-customization/
- GitHub: https://github.com/microsoft/vscode
- Author: [@microsoft](https://omgskills.com/library/microsoft/index.md)

## More from this repo

- [customizations-in-the-agent-host](https://omgskills.com/library/microsoft/vscode/dot-github/skills/customizations-in-the-agent-host/index.md) — Architecture and hard-won debugging lessons for customization enablement (plugins, MCP servers, agents, skills,...
   - [@microsoft](https://omgskills.com/library/microsoft/index.md) · 195k stars
- [agent-host-logs](https://omgskills.com/library/microsoft/vscode/agent-host-logs/index.md) — Used to analyze Agent Host debug log exports.
   - [@microsoft](https://omgskills.com/library/microsoft/index.md) · 194k stars
- [chat-customizations-editor](https://omgskills.com/library/microsoft/vscode/chat-customizations-editor/index.md) — Used when working on the Chat Customizations editor — the management UI for agents, skills, instructions, hooks,...
   - [@microsoft](https://omgskills.com/library/microsoft/index.md) · 194k stars