copilot-agent-builder

# GitHub Copilot Agent Builder

Generate custom GitHub Copilot agents following VS Code's `.agent.md` format with proper YAML frontmatter and markdown instructions.

## When to Activate

Trigger this skill when user says:
- "create copilot agent"
- "generate github copilot agent"
- "new copilot agent for [purpose]"
- "make a copilot agent"
- "build copilot agent"
- "copilot custom agent"

## Agent Creation Process

### Step 1: Gather Requirements

Ask user for agent configuration:

1. **Agent Purpose & Name**:
   - What should the agent do? (e.g., "plan features", "review security", "write tests")
   - Suggested name: Extract from purpose (e.g., "planner", "security-reviewer", "test-writer")

2. **Tools Selection** (multi-select):
   - `fetch` - Retrieve web content and documentation
   - `search` - Search codebase and files
   - `githubRepo` - Access GitHub repository data
   - `usages` - Find code references and usage patterns
   - `files` - File operations
   - Custom tools if available

3. **Handoff Workflows** (optional):
   - Should this agent hand off to another? (e.g., planner → coder)
   - Handoff agent name
   - Handoff prompt text
   - Auto-send handoff? (yes/no)

4. **Additional Configuration** (optional):
   - Specific model to use?
   - Argument hint for users?

### Step 2: Validate Directory Structure

```bash
# Ensure .github/agents directory exists
mkdir -p .github/agents
```

### Step 3: Generate Agent File

Create `.github/agents/{agent-name}.agent.md` with:

**YAML Frontmatter Structure**:
```yaml
---
description: [Brief overview shown in chat input]
name: [Agent identifier, lowercase with hyphens]
tools: [Array of tool names]
handoffs:  # Optional
  - label: [Button text]
    agent: [Target agent name]
    prompt: [Handoff message]
    send: [true/false - auto-submit?]
model: [Optional - specific model name]
argument-hint: [Optional - user guidance text]
---
```

**Markdown Body**:
- Clear role definition
- Specific instructions
- Tool usage gui