agent-directory

Discovers and invokes specialist agents from a local agent directory.

Updated Jul 30, 2024
One-click install
npx skills add https://github.com/twidxuga/dotfiles --skill agent-directory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-directory
Source: https://github.com/twidxuga/dotfiles/tree/main/opencode/dot-config/opencode/skills/agent-directory
Command: npx skills add https://github.com/twidxuga/dotfiles --skill agent-directory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Discover and invoke specialist agents from the user's agent/ folder to optimize task delegation by ensuring domain expertise is consulted before resorting to generic handlers.

Core Features & Use Cases

  • Discover available agents in ~/.config/opencode/agent/ and read their frontmatter to determine capabilities.
  • Invoke the best-matched specialist agent for a given task, with fallback to generic categories when no specialist fits.
  • Use cases include design validation, code review, or process optimization guided by agent expertise.

Quick Start

Ask the AI to scan the agent directory and invoke the best-matching agent by frontmatter name.

Frequently Asked Questions about agent-directory

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

FAQPage Schema
How do I discover and invoke specialist agents for task delegation?

To discover specialist agents for task delegation, scan your local agent directory and read the agent metadata frontmatter to determine capabilities. The system then invokes the best-matched specialist agent for the task by using the frontmatter 'name' value as the subagent_type.

How does agent metadata frontmatter work for routing tasks to specialist agents?

Agent metadata frontmatter works for task routing by providing the capability details and the 'name' value required for invocation. The system reads this frontmatter from agents in your local directory to prioritize specialist domain expertise before falling back to generic categories.

What is the best way to automate code review or design validation using local agents?

The best way to automate code review or design validation is to delegate the tasks to specialist agents in your local library. The system scans the directory, reads the frontmatter, and invokes the agent with the matching domain expertise for the specific task.

Do I need specific agent metadata frontmatter to enable task routing?

Yes, you need agent metadata frontmatter to enable task routing. The system requires this frontmatter to determine agent capabilities and specifically uses the frontmatter 'name' value as the subagent_type for invoking the correct specialist for delegation.

What happens when no specialist agent matches my task during delegation?

When no specialist agent matches your task during delegation, the system applies a fallback mechanism. It defaults to invoking generic agent categories to handle the task when no specific domain expertise is available in your local agent directory.

Where are specialist agents stored for local task delegation and discovery?

Specialist agents for local task delegation are stored in your agent directory, specifically located at ~/.config/opencode/agent/. The system discovers available agents by scanning this folder and reading their metadata frontmatter to determine their capabilities.