create-custom-agent

Scaffold VS Code custom agent files with YAML frontmatter and Markdown instructions.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill create-custom-agent-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-custom-agent
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/create-custom-agent
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill create-custom-agent-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It streamlines creating specialized VS Code custom agent personas so your team can standardize workflows with consistent tool access and handoffs.

Core Features & Use Cases

  • Custom agent scaffolding: Generate a properly structured .agent.md file with required frontmatter and clear persona instructions.
  • Tool and workflow configuration: Define allowed tools/tool sets and set up handoffs to other agents for multi-step processes.
  • Operational safety by design: Prevent unintended subagent invocation and control whether the agent is user-invokable.

Quick Start

Ask the assistant to create a new custom agent file named "planner" that uses the tools search and codebase and includes a handoff to an "implementation" agent.

Frequently Asked Questions about create-custom-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom agent in VS Code for specialized development workflows?

To create a custom agent, generate a `.agent.md` file with YAML frontmatter defining the name, description, tools, and handoffs, followed by Markdown instructions for the agent persona.

What is YAML frontmatter and how does it configure VS Code custom agents?

YAML frontmatter is the header block in an agent definition file specifying the name, description, allowed tool sets, and handoff targets to standardize workflows and control operational safety.

Can I chain multiple custom agents together for multi-step development processes?

Yes, you can chain custom agents by defining handoffs in the YAML frontmatter, allowing one agent to transfer control to another implementation or planning agent for sequential tasks.

How do I restrict tool access for a VS Code custom agent?

You restrict tool access by specifying allowed tools in the YAML frontmatter of the `.agent.md` file, ensuring the specialized persona only uses permitted tool sets during execution.

Does this custom agent scaffolding prevent unintended subagent invocation?

Yes, the scaffolding provides operational safety by design, allowing you to control whether the agent is user-invokable and preventing unintended subagent activation during automated workflows.