# VSCode Copilot Instructions Skill
Expert guidance for building custom instructions for GitHub Copilot in Visual Studio Code.
## 🎯 What This Skill Covers
Build comprehensive custom instructions for GitHub Copilot with support for all instruction file types.
**Instruction File Types**:
- `.github/copilot-instructions.md` - Always-on workspace instructions
- `.instructions.md` - Conditional instructions with `applyTo` glob patterns
- `AGENTS.md` - Multi-agent workspace configuration
- `.prompt.md` - Reusable on-demand prompts
**Additional Topics**:
- Variables (`${workspaceFolder}`, `${file}`, `${selection}`, `${input:name}`)
- Tool references (`#tool:files`, `#tool:githubRepo`)
- Glob patterns for conditional instructions
- Best practices and troubleshooting
**Use when**: Creating or customizing GitHub Copilot instructions, configuring Copilot Chat, or working with instruction files.
## 📦 Installation
```bash
claude skill add --from https://github.com/featbit/coding-agent-instructions-skills
```
## 🚀 Quick Start
### Using VSCode Copilot Instructions Skill
```
You: "Create copilot instructions for my TypeScript React project"
Claude: [Activates vscode-copilot-instructions skill]
[Generates .github/copilot-instructions.md with React/TS best practices]
You: "Add conditional instructions for test files"
Claude: [Creates .instructions.md with applyTo pattern for test files]
```
### Using Claude Custom Instructions Skill
```
You: "Create copilot instructions for my TypeScript React project"
Claude: [Activates vscode-copilot-instructions skill]
[Generates .github/copilot-instructions.md with React/TS best practices]
You: "Add conditional instructions for test files"
Claude: [Creates .instructions.md with applyTo pattern for test files]
You: "Create a prompt file for generating API endpoints"
Claude: [Creates .prompt.md with YAML frontmatter and prompt template
│ ├── agents-md-guide.md
│ ├── prompt-files-guide.md
```
skills/vscode-copilot-instructions/
├── SKILL.md # Main skill file
├── references/ # Detailed guides
│ ├── copilot-instructions-guide.md
│ ├── instructions-files-guide.md
│ ├── agents-md-guide.md
│ ├── prompt-files-guide.md
│ ├── variables-and-references.md
│ ├── best-practices.md
│ └── troubleshooting.md
└── assets/templates/ # Ready-to-use templates
├── copilot-instructions.template.md
├── instructions-file.template.md
├── agents.template.md
└── prompt-file.template.md
```
**Comprehensive coverage**:
- 8,000+ lines of documentation
- 4 instruction file types explained in depth
- 25+ examples across different tech stacks
- Glob pattern reference and debugging
- Complete troubleshooting guide
- Variables and tool references
- Progressive disclosure best practice
### Platform Coverage
**VSCode Copilot Instructions**:
- ✅ VSCode with GitHub Copilot
- ✅ GitHub.com
- ✅ Visual Studio
**Claude Custom Instructions**:
- ✅ Claude.ai Web
- ✅ Claude Desktop (macOS, Windows, Linux)
- ✅ VSCode Extensions (select)
- ✅ Claude API
### Comprehensive Templates
- **Copilot**: 4 templates covering all instruction file types
- **Claude**: Developer templates, MCP configurations, project setups
- All templates include:
- Inline documentation
- Real-world examples
- Common patterns
- Best practices
## 🔧 Requirements
- **For VSCode Copilot Instructions**:
- Visual Studio Code with GitHub Copilot extension
- Settings configured (documented in skill)
- **For Claude Custom Instructions**:
- Claude account (Free or Pro)
- For MCP: Claude Desktop or API access
- For Projects: Claude Pro subscription
- ✅ VSCode with GitHub Copilot
- ✅ GitHub.com (copilot-instructions.md)
- ✅ Visual Studio
### Comprehensive Templates
4 ready-to-use templates covering all instruction file types:
- `.github/copilot-instructions.md` - Always-on instructions template
- `.instructions.md` - Conditional instructions with applyTo patterns
- `AGENTS.md` - Multi-agent workspace template
- `.prompt.md` - Reusable prompt template with YAML frontmatter
All templates include:
- Visual Studio Code with GitHub Copilot extension
- GitHub Copilot subscription (Individual, Business, or Enterprise)
- Settings configuration (documented in skill):
- `github.copilot.chat.codeGeneration.useInstructionFiles`: true
- `chat.includeApplyingInstructions`: true
- `chat.useAgentsMdFile`: truet preferences for Python backend work"
Claude uses claude-custom-instructions skill:
1. Guides through custom instructions structure
2. Suggests Python-specific preferences (PEP 8, type hints, pytest)
3. Recommends MCP servers:
- Filesystem for project access
- PostgreSQL for database queries
4. Provides complete configuration files
```
### Example 3: Set Up Multi-Agent Workspace
```
You: "Create AGENTS.md for a microservices project with multiple AI assistants"
Claude uses vscode-copilot-instructions skill:
1. Creates AGENTS.md with:
- Universal rules for all agents
- Restricted areas (auth, payments)
- Service-specific patterns
- Team workflows
2. Includes examples from microservices architecture
```t Instructions**:
- Glob pattern best practices
- Variable substitution patterns
- Tool reference integration
- Cross-platform compatibility
**Claude Custom Instructions**:
- Multi-platform configuration strategies
- MCP server security
- ✅ Progressive disclosure (concise → detailed documentation)
- ✅ Glob pattern best practices for conditional instructions
- ✅ Variable substitution patterns (`${workspaceFolder}`, `${file}`, etc.)
- ✅ Tool reference integration (`#tool:files`, `#tool:githubRepo`)
- ✅ Security considerations (no secrets in instructions)
- ✅ Token efficiency (optimized for context windows)
- ✅ Team collaboration strategies
- ✅ Cross-platform compatibility (VSCode, GitHub.com, Visual Studio)
- ✅ Regular maintenance patterns
### Official Documentation
**GitHub Copilot**:
- [Custom Instructions](https://code.visualstudio.com/docs/copilot/copilot-customization)
- [Prompt Files](https://code.visualstudio.com/docs/copilot/prompt-crafting)
**Claude AI**:
- [Claude Documentation](https://docs.anthropic.com/)
- [MCP Documentation](https://modelcontextprotocol.io/)
- [Claude Pro Projects](https://support.anthropic.com/)
### Related Skills
- [agent-skills-best-practices](https://github.com/featbit/skills-build-best-practice) - Meta-skill for building skills
## 📊 Version History
### 1.0.0 (2024-02-08)
**Initial Release**:
- vscode-copilot-instructions skill with 4 instruction file types
- claude-custom-instructions skill with MCP integration
- 8 comprehensive reference guides
- 6 ready-to-use templates
- 25+ examples across different scenarios
- Complete troubleshooting documentation
See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
## 💬 Support
- [GitHub Copilot Custom Instructions](https://code.visualstudio.com/docs/copilot/copilot-customization)
- [GitHub Copilot Prompt Files](https://code.visualstudio.com/docs/copilot/prompt-crafting)
- [GitHub Copilot Documentation](https://docs.github.com/copilot
- [GitHub Copilot Documentation](https://code.visualstudio.com/docs/copilot)
- [Anthropic Claude Documentation](https://docs.anthropic.com/)
- [Model Context Protocol](https://modelcontextprotocol.io/)
- Community feedback and real-world usage
---
**Made with ❤️ by [FeatBit](https://github.com/featbit)**
*Helping developers build better AI coding agent configurations*
7 comprehensive reference guides (800-1400 lines each)
- 4 ready-to-use templates
- 25+ examples across different tech stacks
- Complete troubleshooting documentation
- Variables and tool references guide
- Best practices guide