skills.rest
PracticalSwan
PracticalSwanCOMMUNITY
Explore all skills by this author →
GitHub

custom-agent-usage

Discover, validate, and invoke custom agents from `.agent.md` files.

7|2|Updated Feb 20, 2026
Search Tags:#automation#discovery#delegation#agent#subagent#custom agent
One-click install
npx skills add https://github.com/PracticalSwan/agent-skills --skill custom-agent-usage
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: custom-agent-usage
Source: https://github.com/PracticalSwan/agent-skills/tree/main/custom-agent-usage
Command: npx skills add https://github.com/PracticalSwan/agent-skills --skill custom-agent-usage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of finding, validating, and invoking custom AI agents defined locally, making it easier to leverage specialized agent functionalities.

Core Features & Use Cases

  • Agent Discovery: Locates .agent.md files in specified local directories (Claude, VS Code Insiders).
  • Invocability Check: Verifies if an agent can be used as a subagent by checking the disable-model-invocation flag.
  • Agent Name Retrieval: Extracts the correct agentName for delegation.
  • Use Case: You need to delegate a complex testing task to a specialized agent. This Skill helps you find the right testing agent, confirm it's ready for use, and get its exact name for the runSubagent command.

Quick Start

Find all custom agents in your local directories and list the ones that can be invoked as subagents.

Frequently Asked Questions about custom-agent-usage

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

FAQPage Schema
How do I discover custom agents defined in local directories?▼

To discover custom agents, locate `.agent.md` files within specified local directories such as Claude or VS Code Insiders. This process identifies available specialized agents and retrieves their exact names for task delegation.

How do I check if a custom agent is invocable as a subagent?▼

Check the frontmatter of the `.agent.md` file for the `disable-model-invocation: false` flag. This verification confirms the agent is enabled and ready to be used as a subagent for delegation tasks.

What is the best way to get the correct agent name for subagent delegation?▼

Retrieve the correct agent name by extracting the `agentName` field from the `.agent.md` file's frontmatter. This ensures accurate identification when passing commands to the `runSubagent` command for task delegation.

Does VS Code Insiders support discovering custom agents via `.agent.md` files?▼

Yes, VS Code Insiders supports discovering custom agents defined via `.agent.md` files. The discovery process scans local directories associated with VS Code Insiders to locate and validate available agents.

Why does subagent delegation fail when using a custom agent?▼

Subagent delegation fails if the `.agent.md` file has `disable-model-invocation: true` in its frontmatter. This flag explicitly prevents the agent from being invoked as a subagent by the model.

Related Skills

Explore More Software Engineering Skills→
ZoimbackZoimback

subagent-custom-agent

Create custom .agent.md files for GitHub Copilot subagents.

Community
Intermediate
1uc4sm4theus1uc4sm4theus
20

code_review

Analyze source files and git history to generate implementation plans and root cause analysis.

Community
Advanced
cryptofish7cryptofish7

ralph

Automate task discovery, sequencing, execution via Task Runner subagents across software projects with PRs and CI pipelines.

Community
Advanced
bastani-incbastani-inc
484

disable-model-invocation

Prevent automatic model selection of manually controlled skills via SKILL.md frontmatter flag.

Official
Basic