domains / families / agent-tooling / create-custom-agent

create-custom-agent

separate

Creates VS Code custom agent files (.agent.md) for specialized AI personas with tools, instructions, and handoffs. Use when scaffolding new custom agents, configuring agent workflows, or setting up agent-to-agent handoffs.

When to use

• Creating a new custom agent from scratch
• Scaffolding an `.agent.md` file with proper frontmatter
• Setting up agent-to-agent handoffs for multi-step workflows
• Configuring tool restrictions for specialized roles (planner, reviewer, etc.)
• Creating workspace-shared or user-profile agents

When not to use

• Creating instruction files (use `.instructions.md` instead)
• Creating reusable prompts (use `.prompt.md` instead)
• Modifying existing agents (edit the file directly)

Skill page

Source