create-agent

$npx mdskill add microsoft/vscode/create-agent

Generate a custom agent definition file (.agent.md) based on conversation context or explicit requirements.

  • Automates the creation of specialized AI agents for niche tasks or roles.
  • Relies on conversation history and user input to define scope and behavior.
  • Guides the user through drafting, refining, and finalizing the agent's operational parameters.
  • Outputs a structured agent file and suggests next steps for immediate adoption.
SKILL.md
.github/skills/create-agentView on GitHub ↗
---
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.
More from microsoft/vscode