build-skills-index

Scan SKILL.md files to generate a categorized skills-index.yaml file.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that your AI agent always has an up-to-date and accurate list of all available skills, enabling efficient discovery and utilization.

Core Features & Use Cases

  • Automated Indexing: Scans all SKILL.md files to build a comprehensive skills-index.yaml.
  • Metadata Aggregation: Extracts essential metadata like name, description, ID, category, and tags from each skill.
  • Use Case: After adding a new custom skill to your project, this skill automatically updates the central index so the AI can immediately find and use the new skill.

Quick Start

Run the build-skills-index skill to refresh the skills catalog.

Frequently Asked Questions about build-skills-index

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

FAQPage Schema
How do I automatically catalog all available skills from SKILL.md files?

You can catalog skills by scanning all SKILL.md files within the .gaai/core/skills/ directory to automatically generate a derived skills-index.yaml file aggregating their YAML frontmatter metadata.

How does skills metadata aggregation handle duplicate IDs and missing fields?

Skills metadata aggregation extracts frontmatter fields like name, description, and category, then reports on total skills scanned, missing required fields, and duplicate IDs to ensure catalog integrity.

What is the best way to maintain an up-to-date skills index for AI agent discovery?

The best way to maintain an up-to-date skills index is to run an automated scan of all SKILL.md files, which extracts and organizes metadata by category into a central skills-index.yaml file.

What metadata fields are extracted when building a skills index?

When building a skills index, the tool extracts YAML frontmatter fields including name, description, ID, category, track, tags, version, and updated_at, organizing them by category.

Why does my AI agent fail to find newly added custom skills?

Your AI agent may fail to find newly added custom skills if the central skills-index.yaml file is outdated, requiring a rescan of SKILL.md files to refresh the catalog and ensure discoverability.