Agent skill · software engineering · microsoft
create-agent
Create a custom agent (.agent.md) for a specific job.
Why this skill is useful
Provides a structured process for creating specialized agents, including domain-specific roles and tool preferences that the AI wouldn't reliably generate on its own.
What it needs
About 1k tokens when loaded. Last updated 2026-08-07. 188,455 stars on the source repository.
What this skill does
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.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills microsoft/create-agent