agent-customization
**WORKFLOW SKILL** — Create, update, review, fix, or debug VS Code agent customization files (.instructions.md, .prompt.md,…
@microsoftInstall SkillDevelopment
Skill
/create-agent
Create a custom agent (.agent.md) for a specific job.
Claude Code
$ npx -y skills add microsoft/vscode --skill create-agent --agent claude-code
Codex
$ npx skills add microsoft/vscode --skill create-agent -a codex -y
Cursor
$ npx skills add microsoft/vscode --skill create-agent -a cursor -y
Gemini CLI
$ npx skills add microsoft/vscode --skill create-agent -a gemini-cli -y
GitHub Copilot
$ npx skills add microsoft/vscode --skill create-agent -a github-copilot -y
OpenCode
$ npx skills add microsoft/vscode --skill create-agent -a opencode -y
Windsurf
$ npx skills add microsoft/vscode --skill create-agent -a windsurf -y
SKILL.md
create-agent.SKILL.mdname: 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.
Stats
195,301
Stars
43,805
Forks
Active
Maintenance
TypeScript
Language
MIT
License
Last commit
Created
195k26 skills1 MCP
Stars on GitHub
Momentum
- stars in total
- 195.3k
Other skills on vscode.
@microsoftInstall Skillchronicle
Analyze Copilot session history for standup reports, usage tips, session search, and session reindexing. Use when the user asks…
@microsoftInstall Skillcreate-canvas
Create a Copilot extension canvas at user, workspace, or plugin scope.
@microsoftInstall Skillcreate-hook
Create a hook (.json) to enforce policy or automate agent lifecycle events.
@microsoftInstall Skillcreate-instructions
Create an instructions file (.instructions.md) for a project rule or convention.
@microsoftInstall SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about create-agent.
- Which coding agents can use create-agent?
- create-agent installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.