Skip to main content
create-custom-agentby .NETOfficialDevelopmentGitHub stars: 5.5k

Create Custom Agent skill: what it does and how to install it

Creates VS Code custom agent files with personas, tool permissions, instructions and handoffs for specialised development workflows.

Summary generated from the skill's documentation.

Install

$ npx skills add dotnet/skills --skill create-custom-agent

Run it in a terminal. If your agent is already running, start a new session so it picks the skill up.

About this skill

What it does. Scaffolds .agent.md files in an agents/ directory, adding YAML frontmatter for descriptions, tools, models and handoffs, then defining the agent's role, workflow and constraints. It also covers validation through VS Code's custom-agent diagnostics and agents dropdown.

When to use it. Use it to create new workspace-shared or user-profile agents, including planners, reviewers and multi-step handoff workflows. Do not use it for instruction files, reusable prompts or editing existing agents.

History

Repo stars

5.5kAbout +384 since 9 Jul 2026

Before 1 Oct 2026 the curve is estimated from public event data.

Stars are counted for the whole repository, which holds 18 skills.

Show as a table
Repo stars by day
DateRepo stars
1 Oct 20265,531
24 Sept 2026 (estimated)5,519
17 Sept 2026 (estimated)5,494
10 Sept 2026 (estimated)5,419
3 Sept 2026 (estimated)5,258
27 Aug 2026 (estimated)5,233
20 Aug 2026 (estimated)5,221
13 Aug 2026 (estimated)5,221
6 Aug 2026 (estimated)5,171
30 Jul 2026 (estimated)5,159
23 Jul 2026 (estimated)5,159
16 Jul 2026 (estimated)5,147
9 Jul 2026 (estimated)5,147

Installs

2.4k

Tracking since . A chart appears once there are 7 days of data.

Installs via skills.sh

Similar skills