vscode copilot customization
- Repo stars 0
- Author repo skills-registry
- Domain
- Other
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# VS Code Copilot Customization
## Decision Matrix
Use this matrix to recommend the right customization type. Always start here.
| Scenario | Best choice |
| ------------------------------------------------------------------- | ---------------------------------- |
| Project-wide coding standards, always active | `copilot-instructions.md` |
| Rules only for specific file types / folders | `*.instructions.md` with `applyTo` |
| Works with multiple AI agents (Claude, Copilot, etc.) | `AGENTS.md` |
| Reusable task you invoke manually in chat | Prompt file (`.prompt.md`) |
| Specialized workflow with tool restrictions or model choice | Custom agent (`.agent.md`) |
| Portable capability reusable across projects + CLI + cloud agents | Agent skill (`SKILL.md`) |
| Auto-run commands at agent lifecycle points (format, lint, enforce) | Hook (`.json`) |
| Bundle multiple customizations to share or distribute | Agent plugin (`plugin.json`) |
### Quick decision flow
```
Do you want it ON automatically for every request?
├─ YES → Instructions (.instructions.md / copilot-instructions.md / AGENTS.md)
└─ NO, I invoke it manually →
Does it need persistent persona, tool restrictions, or model choice?
├─ YES → Custom Agent (.agent.md)
└─ NO →
Is it a reusable multi-agent portable capability?
├─ YES → Agent Skill (SKILL.md)
└─ NO → Prompt File (.prompt.md)
Do you want to run shell commands around agent actions?
└─ YES → Hook (hooks/*.json)
Do you want to bundle everything for distribution?
└─ YES → Agent Plugin (plugin.json)
```
---
## 1. Custom Instructions
Always-on context and rules. Stored in `.github/copilot-instructions.md` (workspace-wide), `AGENTS.md` (multi-agent), or `*.instructions.md` (file-scoped via `applyTo` glob).
Read `references/instructions.md` when asked to create, write, or configure custom instructions.
---
## 2. Prompt Files
Reusable task templates invoked manually via `/` slash command. Stored in `.github/prompts/*.prompt.md`.
Read `references/prompt-files.md` when asked to create a prompt file or reusable chat task.
---
## 3. Custom Agents
Specialized Copilot persona with tool whitelist, model choice, and optional handoffs. Stored in `.github/agents/*.agent.md`.
Read `references/custom-agents.md` when asked to create a custom agent or chat mode.
---
## 4. Agent Skills
Portable, progressive-loading capabilities that work across VS Code, Copilot CLI, and cloud agents. Stored in `.github/skills/<name>/SKILL.md`.
Read `references/agent-skills.md` when asked to create a skill or when the user asks about SKILL.md format, frontmatter fields, or skill best practices.
---
## 5. Hooks
Shell commands triggered at agent lifecycle events (`PostToolUse`, `Stop`, etc.). Stored in `.github/hooks/*.json`.
Read `references/hooks.md` when asked to create a hook, set up auto-formatting, or run commands around agent actions.
---
## 6. Agent Plugins
Bundle skills, agents, hooks, and MCP servers for distribution. Defined in `plugin.json`.
Read `references/plugins.md` when asked to create, publish, or install an agent plugin.
---
## File Locations Reference
| Type | Workspace location | User profile location |
| ------------------------------------ | ---------------------------------------- | ------------------------- |
| Always-on instructions (Copilot) | `.github/copilot-instructions.md` | — |
| Always-on instructions (multi-agent) | `AGENTS.md` | — |
| Targeted instructions | `.github/instructions/*.instructions.md` | `~/.vscode/instructions/` |
| Prompt files | `.github/prompts/*.prompt.md` | `~/.vscode/prompts/` |
| Custom agents | `.github/agents/*.agent.md` | `~/.vscode/agents/` |
| Agent skills | `.github/skills/<name>/SKILL.md` | `~/.vscode/skills/` |
| Hooks | `.github/hooks/*.json` | `~/.vscode/hooks/` |
| Claude Code agents | `.claude/agents/*.md` | — |
| Claude Code rules | `.claude/rules/*.md` | — |
---
## AI Generation Commands
```
/init → workspace-wide copilot-instructions.md
/create-instruction → targeted .instructions.md
/create-prompt → .prompt.md file
/create-agent → .agent.md file
/create-skill → agent skill directory
/create-hook → hook JSON file
```
Open the **Chat Customizations editor** for a visual overview:
```
Command Palette → "Chat: Open Chat Customizations"
```
---
## Reference files
- `references/instructions.md` – Custom instructions templates and settings
- `references/prompt-files.md` – Prompt file templates and input variables
- `references/custom-agents.md` – Agent templates and handoff configuration
- `references/agent-skills.md` – Skill format, progressive loading, official docs
- `references/hooks.md` – Hook templates, events, naming convention
- `references/plugins.md` – Plugin structure and distribution
- `references/frontmatter-reference.md` – Complete frontmatter field reference for all types
- `references/examples.md` – Real-world examples organized by use case
---
> Source: [danielsitek/skills](https://github.com/danielsitek/skills) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
Sections and files
Listed in source order.
sections -> Decision Matrix → Quick decision flow → 1. Custom Instructions → 2. Prompt Files → 3. Custom Agents → 4. Agent Skills
terms -> Chat Customizations editor · Use this matrix to recommend the right customization type. · Do you want to run shell commands around agent actions? · Do you want to bundle everything for distribution? · Always-on context and rules. · Read references/instructions.md when asked to create, write, or configure custom instructions. · Reusable task templates invoked manually via / slash command. · Read references/prompt-files.md when asked to create a prompt file or reusable chat task.
files/cmd -> copilot-instructions.md · *.instructions.md · applyTo · AGENTS.md · .prompt.md · .agent.md · .json · plugin.json
body sha256 -> 67d49b2219b6
Decision Matrix
Use this matrix to recommend the right customization type. Always start here. Scenario · Best choice Project-wide coding standards, always active ·
copilot-instructions.mdRules only for specific file types / folders ·*.instructions.mdwithapplyToWorks with multiple AI agents (Claude, Copilot, etc.) ·AGENTS.md1. Custom Instructions
Always-on context and rules. Stored in
.github/copilot-instructions.md(workspace-wide),AGENTS.md(multi-agent), or*.instructions.md(file-scoped viaapplyToglob). Readreferences/instructions.mdwhen asked to create, write, or configure custom instructions.2. Prompt Files
Reusable task templates invoked manually via
/slash command. Stored in.github/prompts/*.prompt.md. Readreferences/prompt-files.mdwhen asked to create a prompt file or reusable chat task.3. Custom Agents
Specialized Copilot persona with tool whitelist, model choice, and optional handoffs. Stored in
.github/agents/*.agent.md. Readreferences/custom-agents.mdwhen asked to create a custom agent or chat mode.4. Agent Skills
Portable, progressive-loading capabilities that work across VS Code, Copilot CLI, and cloud agents. Stored in
.github/skills/<name>/SKILL.md. Readreferences/agent-skills.mdwhen asked to create a skill or when the user asks about SKILL.md format, frontmatter fields, or skill best practices.