skills.rest
Fr-e-d
Fr-e-dCOMMUNITY
Explore all skills by this author →
GitHub

build-agents-index

Generate agents-index.yaml by scanning .gaai/core/agents/ and merging specialist registry data.

157|28|Updated Feb 7, 2026
Search Tags:#agents#catalog#governance#registry#discoverability#index
One-click install
npx skills add https://github.com/Fr-e-d/GAAI-framework --skill build-agents-index-fr-e-d
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-agents-index
Source: https://github.com/Fr-e-d/GAAI-framework/tree/main/.gaai/core/skills/cross/build-agents-index
Command: npx skills add https://github.com/Fr-e-d/GAAI-framework --skill build-agents-index-fr-e-d

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures a centralized, up-to-date catalog of all available agents and specialists within the GAAI framework, crucial for discoverability and onboarding.

Core Features & Use Cases

  • Automated Index Generation: Scans agent definition files and specialist registries to create a unified index.
  • Discoverability Enhancement: Provides a single source of truth for agents, aiding in their selection and use.
  • Use Case: After adding a new sub-agent for code refactoring, activate this skill to automatically update the agents-index.yaml so that other agents can discover and utilize the new refactoring capabilities.

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 catalog all agents and sub-agents in a directory?▼

Generate a comprehensive agents-index.yaml by recursively scanning the .gaai/core/agents/ directory for definition files and merging the data with a specialist registry for centralized discoverability.

What is an agents index used for in agent governance?▼

An agents index provides a single source of truth for agent onboarding and status reporting, ensuring centralized discoverability and governance so other agents can find and utilize available specialists.

How do I update the agent registry after adding a new sub-agent?▼

Update the agent registry by running an automated index generation process that scans agent definition files and extracts YAML frontmatter to automatically merge new sub-agents into the unified agents-index.yaml catalog.

Does the agent catalog support recursive traversal of nested definition directories?▼

Yes, the agent catalog generation requires recursive traversal of agent definition directories to ensure all nested sub-agent definition files are discovered and included in the final index.

What file format is used for the unified agent catalog?▼

The unified agent catalog uses the agents-index.yaml file format, which consolidates YAML frontmatter extracted from agent definition files and specialist registry data into a single source of truth.

When should I regenerate the agents index?▼

Regenerate the agents index whenever new agents or sub-agents are added to the .gaai/core/agents/ directory, ensuring the catalog remains an up-to-date source for other agents to discover available capabilities.

Related Skills

Explore More Software Engineering Skills→
bketelsenbketelsen
1

build-agents-index

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

Community
Basic
petrSimonidesXartpetrSimonidesXart

build-agents-index

Merge agent and sub-agent frontmatter into a single agents-index.yaml file.

Community
Intermediate
jimmi2051jimmi2051

omc-reference

Catalog OMC agents, tools, and skills for orchestration reference.

Community
Basic
bketelsenbketelsen
1

build-skills-index

Scan SKILL.md files and generate a consolidated skills-index.yaml file.

Community
Basic