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.