Copilot Audit Setup.prompt

---
description: Audit the repository's Copilot customization setup and suggest improvements
name: Audit Copilot Setup
agent: Copilot Customization Builder
tools: ['search', 'editFiles']
---

# Audit Copilot Setup

Analyze this repository's GitHub Copilot customization and provide recommendations.

## Audit Scope

Focus area (optional): `${input:focusArea:Leave empty for full audit, or specify: instructions, agents, prompts, skills, hooks, MCP, plugins, toolsets, org, settings}`

## Audit Workflow

### Step 1: Scan Repository Structure

Check for existence and content of:

1. **Instructions**
   - `.github/copilot-instructions.md`
   - `.github/instructions/*.instructions.md`
   - `AGENTS.md` (root and subfolders)
   - `CLAUDE.md` and `.claude/rules/*.md` when present

2. **Custom Agents**
   - `.github/agents/*.agent.md`
   - Legacy: `.github/chatmodes/*.chatmode.md` (should migrate)

3. **Prompt Files**
   - `.github/prompts/*.prompt.md`

4. **Agent Skills**
   - `.github/skills/*/SKILL.md`

5. **Hooks**
   - `.github/hooks/*.json`
   - Inert examples such as `.github/hooks/*.json.example`

6. **MCP**
   - `.vscode/mcp.json`
   - `.vscode/mcp.example.json`
   - Agent frontmatter `mcp-servers`
   - Plugin `.mcp.json` / `mcpServers`

7. **Agent Plugins and Tool Sets**
   - `plugin.json` / `plugin.example.json`
   - `.github/toolsets/*.jsonc`

8. **Settings**
   - `.vscode/settings.json`

### Step 2: Validate Existing Files

For each file found, check:
- Valid YAML frontmatter
- Required fields present
- No deprecated patterns
- Best practices followed

### Step 3: Identify Gaps

Based on project type, suggest missing customizations:
- Language-specific instructions
- Common workflow agents
- Repetitive task prompts
- Project knowledge skills
- MCP integrations for trusted external tools/data
- Tool sets for repeated tool bundles
- Agent plugins when a workflow should be packaged/distributed
- Organization/enterprise defaults vs repository overrides

### Step 4: Generate Report

Output a structured report with: