Agent Capability Discovery
Purpose and Intent
The agent-capability-discovery skill is the "brain" of a multi-agent system. It allows an agent to self-reflect and understand what tools and expertises are available within its environment by indexing all skill.yaml files.
When to Use
- System Initialization: Run this when an agent starts up to populate its internal tool list.
- Routing Decisions: Use this when a master agent receives a complex user request and needs to identify which specialized skill (e.g.,
hipaa-compliance-guardvs.pii-sanitizer) is best suited for the job. - Documentation Generation: Automatically keep a "Global Skills Map" up to date for human developers.
When NOT to Use
- Skill Execution: This skill only discovers what is possible; it does not execute the other skills.
- External Tooling: It only indexes skills defined in the local repository structure.
Input and Output Examples
Input
base_directory: "."
output_format: "markdown"
Output
A markdown table or JSON object listing all discovered skills, their descriptions, and their primary capabilities.
Error Conditions and Edge Cases
- Broken YAML: If a
skill.yamlis malformed, the discovery tool will skip that directory and report a warning. - Circular Dependencies: This tool does not handle execution dependencies, only discovery.
Security and Data-Handling Considerations
- Metadata Only: The tool only reads the definition files; it never touches actual source code or data unless instructed by the indexed skills themselves.
- Local Scope: Discovery is confined to the provided root directory to prevent directory traversal attacks.