subagents

Scan filesystem directories for subagent YAML frontmatter and categorize by filename prefixes.

1|Updated Jul 11, 2019

Search Tags:#search #subagents #yaml #metadata #fetch #filesystem #local

Ready to run

npx skills add https://github.com/crsiebler/dotfiles --skill subagents-crsiebler

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: subagents
Source: https://github.com/crsiebler/dotfiles/tree/main/ai/opencode/skills/subagents
Command: npx skills add https://github.com/crsiebler/dotfiles --skill subagents-crsiebler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Local development and knowledge work depend on discovering and reusing subagents defined on disk. This tool provides fast visibility into available subagents by scanning a designated agents directory and reading YAML frontmatter that describes each agent's capabilities.

Core Features & Use Cases

Discover and browse available subagents from $HOME/.config/opencode/agents/.
List subagents by category inferred from filename prefixes, and search by keywords in frontmatter.
Fetch the full markdown definition for a selected subagent for quick review or import into other workflows.

Quick Start

Run the tool to list, search, or fetch subagent definitions from $HOME/.config/opencode/agents.

Frequently Asked Questions about subagents

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

FAQPage Schema

How do I search for locally defined subagents on my filesystem?▼

To search for locally defined subagents, this tool scans your local filesystem directory for agent definitions and parses their YAML frontmatter. It matches keywords against the name, description, tools, and category metadata to surface relevant results.

How do I list available subagents by category from a local directory?▼

Listing available subagents by category is done by scanning the designated agents directory and inferring categories from filename prefixes. The tool parses YAML frontmatter to group and display the agents for quick browsing.

Can I fetch the full markdown definition of a specific subagent?▼

You can fetch the full markdown definition of a specific subagent by selecting it from the search or list results. The tool reads the complete file content from the local filesystem for quick review or import into other workflows.

Does this subagent scanner work with YAML frontmatter metadata?▼

Yes, the subagent scanner works directly with YAML frontmatter metadata. It parses fields like name, description, tools, and category from the markdown files to categorize agents and support search operations.

What happens if the local agents directory is missing or returns empty results?▼

If the local agents directory is missing or returns empty results, the tool includes error handling to manage these scenarios gracefully. It will surface a notification indicating the missing directory or lack of available subagent definitions.

What is the default filesystem path used to discover local subagents?▼

The default filesystem path used to discover local subagents is $HOME/.config/opencode/agents/. The tool scans this specific directory to find, parse, and categorize available agent definitions.