build-skills-indices

Scan core and project skill directories and generate a unified YAML index.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/bketelsen/truenas-mcp --skill build-skills-indices
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-skills-indices
Source: https://github.com/bketelsen/truenas-mcp/tree/main/.gaai/core/skills/cross/build-skills-indices
Command: npx skills add https://github.com/bketelsen/truenas-mcp --skill build-skills-indices

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill consolidates all skill metadata into a single, unified index, eliminating the need to manage separate core and project skill lists and ensuring fast, comprehensive discovery.

Core Features & Use Cases

  • Unified Indexing: Scans both .gaai/core/skills/ and .gaai/project/skills/ for SKILL.md files.
  • Metadata Extraction: Extracts id, name, description, category, track, tags, and updated_at from each SKILL.md.
  • Categorization & Sorting: Organizes skills by track (discovery, delivery, cross), then by category and name.
  • Use Case: After adding a new project skill, run this to automatically update the central skills-index.yaml so that all agents can discover it.

Quick Start

Invoke the build-skills-indices skill to regenerate the unified index.

Frequently Asked Questions about build-skills-indices

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

FAQPage Schema
How do I consolidate skill metadata from multiple directories into a single index?

Unified skill indexing extracts frontmatter fields like id, name, description, category, track, tags, and updated_at from SKILL.md files, categorizing them by track, category, and name into a single YAML index.

When do I need to regenerate a unified skill index for AI agent discovery?

You need to regenerate a unified skill index after adding a new project skill, ensuring the central skills-index.yaml reflects all available metadata for fast, comprehensive AI agent discovery.

Can I organize extracted skill metadata by track and category in a YAML file?

Organizing skill metadata by track, category, and name in a YAML index enables efficient AI agent discovery. The process extracts fields from SKILL.md frontmatter and sorts them accordingly.

Does unified skill indexing work with both core and project skill directories?

Unified skill indexing scans both .gaai/core/skills/ and .gaai/project/skills/ directories, extracts essential frontmatter fields, and consolidates them into a single YAML index file for comprehensive discovery.

What is the best way to automate skill discovery metadata governance?

Automating skill discovery metadata governance involves scanning for SKILL.md files, extracting frontmatter fields, and generating a unified YAML index sorted by track, category, and name for AI agent access.