---
name: "Copilot Customization Standards"
description: "Use when authoring or editing shared Copilot prompts, instructions, agents, skills, hooks, or overlay templates. Covers naming, portability, and frontmatter expectations."
applyTo: "resources/prompts/**/*.prompt.md,resources/instructions/**/*.instructions.md,resources/agents/**/*.agent.md,resources/skills/**/SKILL.md,templates/repo-overlay/.github/instructions/**/*.instructions.md,templates/repo-overlay/.github/agents/**/*.agent.md"
---

- Prefer skills for portable workflows and prompts for VS Code-only adapters.
- Keep descriptions discovery-oriented: say what the resource does and when to
  use it.
- Do not duplicate workflow logic across prompts and skills without a reason.
- Keep shared resources neutral and reusable rather than tied to one machine.
- Treat repository overlays as templates, not as the authoritative shared copy.