build-agents-index

Scan agent definition files and merge registries into agents-index.yaml.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/bketelsen/truenas-mcp --skill build-agents-index
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-agents-index
Source: https://github.com/bketelsen/truenas-mcp/tree/main/.gaai/core/skills/cross/build-agents-index
Command: npx skills add https://github.com/bketelsen/truenas-mcp --skill build-agents-index

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automatically generates a comprehensive and up-to-date index of all available agents, sub-agents, and specialists within the framework, ensuring discoverability and accurate system status.

Core Features & Use Cases

  • Centralized Indexing: Consolidates agent definitions from individual .md files and specialist registries into a single agents-index.yaml.
  • Discoverability: Makes it easy for other agents or tools (like gaai-status) to find and understand available capabilities.
  • Use Case: After adding a new data-analysis.agent.md file, activating this skill ensures that the new agent is immediately discoverable and listed in the central index.

Quick Start

Run the build-agents-index skill to update the agents index.

Frequently Asked Questions about build-agents-index

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

FAQPage Schema
How do I generate a unified index of all my agents from markdown definition files?

To generate a unified agents index, recursively traverse your agent directories to extract YAML frontmatter from .md files and merge specialist registries into a single agents-index.yaml file.

What is the best way to catalog sub-agents and specialists for discoverability?

Cataloging sub-agents and specialists for discoverability involves consolidating individual definition files and registries into a centralized agents-index.yaml, making capabilities easily findable by tools.

How do I update the agent registry after adding a new agent definition file?

Updating the agent registry after adding a new file requires running an indexing process that scans directories, extracts YAML frontmatter, and merges the new definition into the agents-index.yaml.

Can I recursively scan agent directories to extract YAML frontmatter for governance?

Yes, you can recursively scan agent directories to extract YAML frontmatter, which consolidates definitions into a unified index file to support governance and onboarding operations.

Does the agent indexing process work with the GAAI framework for onboarding operations?

Yes, the agent indexing process works with the GAAI framework by generating a centralized agents-index.yaml that supports agent discovery, governance, and onboarding operations across the system.