Skip to content
Development
Skill

/create-agent

Create a custom agent (.agent.md) for a specific job.

From plugin
vscode
189k26 skills
Install
$ npx -y skills add microsoft/vscode --skill create-agent --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/create-agent

Context preview

The summary Claude sees to decide when to auto-load this skill.

Create a custom agent (.agent.md) for a specific job.

SKILL.md

create-agent.SKILL.md
name: create-agent
description: 'Create a custom agent (.agent.md) for a specific job.'
argument-hint: What job should this agent do and how?
disable-model-invocation: true

Related skill: `agent-customization`. Load and follow **agents.md** for template and principles.

Guide the user to create an `.agent.md`.

Extract from Conversation

First, review the conversation history. If the user has been using the agent in a specialized way (e.g., restricting tools, following a specific persona, focusing on certain file types), generalize that into a custom agent. Extract:

  • The specialized role or persona being assumed
  • Tool preferences (which to use, which to avoid)
  • The domain or job scope

Clarify if Needed

If no clear specialization emerges from the conversation, clarify:

  • What job should this agent do?
  • When should it be picked over the default agent?
  • Which tools should it use (or avoid)?

Iterate

1. Draft the agent file and save it. 2. Identify the most ambiguous or weak parts and ask about those. 3. Once finalized, summarize what the agent does, suggest example prompts to try it, and propose related customizations to create next.

Remember to follow the `agent-customization` guidelines to create highly effective agents.

Ships withvscode

Visual Studio Code

Get the whole plugin
Stats
188,564
Stars
41,520
Forks
Active
Maintenance
TypeScript
Language
MIT
License
47m ago
Last commit
10y ago
Created

Repo: microsoft/vscode