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.