build-agents-index

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scans and consolidates agent/frontmatter into a central index to enable consistent discovery and governance across agents and specialists.

Core Features & Use Cases

  • Scan all agent and sub-agent frontmatter in .gaai/core/agents/** to extract metadata.
  • Merge extracted frontmatter with .gaai/core/agents/specialists.registry.yaml to produce a complete index.
  • Generate and update .gaai/core/agents/agents-index.yaml to support onboarding, auditing, and governance workflows.
  • Example: DevOps teams can onboard new agents and automatically reflect them in discovery panels used by AI copilots.

Quick Start

Run the build-agents-index skill whenever you add, modify, or remove any agent, sub-agent, or specialist entry to refresh the derived 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 consolidate agent frontmatter into a single index for governance?

The skill reads frontmatter from .gaai/core/agents and the specialists registry, merges them, and writes the derived agents-index.yaml without modifying any source files.

What is an agents index used for in AI onboarding workflows?

It automatically reflects newly added agents in discovery panels, ensuring the index remains current for governance.

How do I generate an agents-index.yaml file from existing frontmatter?

The skill extracts metadata from .gaai/core/agents/** and merges it with the specialists registry to produce the complete index file.

Does the agents index merge modify the original agent source files?

This ensures your original agent definitions remain untouched while the centralized index stays current.

Can I use a specialists registry to build a unified agents index?

This consolidation ensures all specialist and agent metadata is available for discovery and governance.

When should I refresh the agents index after updating sub-agents?

Running the skill during onboarding and maintenance tasks keeps the governance index up to date.