create-custom-agent

Generates VS Code custom agent files (.agent.md) with structured definitions.

5.1k|377|Updated Feb 3, 2026

Search Tags:#vscode #developer tools #scaffolding #customization #agent #ai persona

Ready to run

npx skills add https://github.com/dotnet/skills --skill create-custom-agent

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: create-custom-agent
Source: https://github.com/dotnet/skills/tree/main/.agents/skills/create-custom-agent
Command: npx skills add https://github.com/dotnet/skills --skill create-custom-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the creation of custom AI agents within VS Code, enabling specialized personas with defined tools and workflows.

Core Features & Use Cases

Agent Scaffolding: Generates .agent.md files with proper YAML frontmatter and Markdown instructions.
Tool & Handoff Configuration: Simplifies the setup of agent capabilities and inter-agent communication.
Use Case: Quickly set up a dedicated 'code-reviewer' agent that only has access to code analysis tools and can hand off complex issues to an 'implementation' agent.

Quick Start

Use the create-custom-agent skill to generate a new agent named 'bug-finder' with a description of 'Finds and reports bugs in code'.

Frequently Asked Questions about create-custom-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I create custom AI agents in VS Code?▼

To create custom AI agents in VS Code, you need to scaffold `.agent.md` files that define specialized AI personas, tools, and instructions. This requires providing an agent name, description, and purpose to generate the structured agent definition file.

What are .agent.md files used for in VS Code?▼

The `.agent.md` files in VS Code are used to define specialized AI personas. They contain YAML frontmatter and Markdown instructions that configure agent capabilities, workflows, and inter-agent handoffs for customized development tasks.

How do I configure agent-to-agent handoffs for custom workflows?▼

Configuring agent-to-agent handoffs involves generating a custom agent file that explicitly defines workflow transitions. You can set up a dedicated agent, like a code-reviewer, to hand off complex issues to an implementation agent within the `.agent.md` configuration.

What inputs do I need to scaffold a new custom agent?▼

Scaffolding a new custom agent requires three primary inputs: an agent name, a description, and a purpose. These inputs are used to automatically generate the structured `.agent.md` definition file with proper YAML frontmatter.

Can I limit an AI persona to only use specific tools in VS Code?▼

Yes, you can limit an AI persona to specific tools by scaffolding a custom agent file. The generated `.agent.md` file allows you to configure tool access, ensuring a specialized agent like a bug-finder only uses code analysis tools.

Does scaffolding custom agents require any external dependencies?▼

Scaffolding custom agents does not require any external dependencies. The process simply generates `.agent.md` files containing YAML frontmatter and Markdown instructions directly within your VS Code environment.