AI Coding Assistant Customization File Specifications
This skill provides the authoritative, up-to-date specifications for all AI coding assistant customization file types. Each file type has its own dedicated reference document with complete attribute tables, validation rules, examples, and best practices.
Standard: These specs align with the Agent Skills open standard and the VS Code Copilot customization documentation.
How to Use This Skill
- Read the Quick Reference below to identify the file type you need.
- Follow the link to the dedicated reference document for full details.
- Use the File Locations reference when you need to know where files go for a specific provider.
- Use the Settings reference for VS Code configuration.
Important: Detailed specifications live in the
references/folder — not in this file. This keeps the main skill file lightweight for efficient context loading per the progressive disclosure model.
Quick Reference
| Type | Extension | Purpose | Reference |
|---|---|---|---|
| Agent | .agent.md / .md | Custom AI personas with specialized behaviors, tool restrictions, and handoff workflows | AGENTS.md |
| Skill | SKILL.md (directory-based) | Reusable, portable capabilities with scripts and resources — follows the Agent Skills open standard | SKILLS.md |
| Prompt | .prompt.md | Reusable prompt templates invoked as slash commands | PROMPTS.md |
| Instruction | .instructions.md | Contextual guidance applied automatically by file type or description | INSTRUCTIONS.md |
| File Locations | — | Provider folder mapping, directory structure, naming conventions | FILE-LOCATIONS.md |
| VS Code Settings | — | Settings that control customization file discovery and behavior | SETTINGS.md |
Provider support
Shared SKILL.md content is portable; agents, rules, prompts, settings and plugin discovery are host-specific. This maintenance skill is not bundled with the WoW plugin. Use FILE-LOCATIONS.md for this repository's source/package mapping. The detailed agent/instruction/prompt examples are Copilot-oriented and are not universal host schemas.
File Type Selection Guide
Use this decision tree to choose the right file type:
-
"I want coding standards applied everywhere" → Use always-on instructions (
.github/copilot-instructions.mdorAGENTS.md). See INSTRUCTIONS.md. -
"I want different rules for different file types" → Use file-based instructions (
.instructions.mdwithapplyTopatterns). See INSTRUCTIONS.md. -
"I have a reusable task I run repeatedly" → Use a prompt file (
.prompt.md) invoked as a slash command. See PROMPTS.md. -
"I need a multi-step workflow with scripts and resources" → Use an Agent Skill (directory with
SKILL.md). Portable across tools. See SKILLS.md. -
"I need a specialized AI persona with tool restrictions" → Use a custom agent (
.agent.md). Supports handoffs for multi-step workflows. See AGENTS.md.


