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.