mcpField
A
agent-capability-discovery

agent-capability-discovery

github.com/jorgealvesAgent workflows2226 installsUpdated 4d ago
Repository

About agent-capability-discovery

agent-capability-discovery indexes local skill.yaml files and summarizes available skills and capabilities for multi-agent systems. It supports startup discovery and task routing, but only catalogs metadata; it does not execute skills or index external tools.

Key features

  1. 01Index local skill.yaml files
  2. 02List skill descriptions and primary capabilities
  3. 03Output Markdown tables or JSON
  4. 04Skip malformed files and report warnings
  5. 05Restrict discovery to the provided root

Use cases

  1. 01Populate an agent's skill list at startup
  2. 02Choose a specialized skill for a complex request
  3. 03Generate and update a global skills map

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jorgealves/agent_skills --skill agent-capability-discovery

After installing, type/agent-capability-discoveryin Claude Code to confirm it loaded.

Bundled filesskill.yaml

Details

From the project README

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-guard vs. 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.yaml is 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.

Comments

Markdown supported