agent-capability-discovery
Scans all skill directories in the repository to generate a comprehensive global map of agent capabilities, inputs, and outputs. Use when you need to understand the full potential of your agent library or when a master agent needs to decide which sub-agent skill to invoke for a complex task.
How do I install this agent skill?
npx skills add https://github.com/jorgealves/agent_skills --skill agent-capability-discoveryIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a metadata discovery tool used to map agent capabilities. While its direct operations are safe, it is vulnerable to indirect prompt injection because it processes descriptions from external files that could contain malicious instructions designed to mislead a master agent.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
2/2 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/jorgealves/agent_skills/agent-capability-discovery">View agent-capability-discovery on skillZs</a>