skills.rest
petrSimonidesXart
petrSimonidesXartCOMMUNITY
Explore all skills by this author →
GitHub

build-skills-index

Scan SKILL.md files to build per-layer YAML skill indices.

Updated Mar 8, 2026
Search Tags:#automation#indexing#discovery#skills#framework#tools#frontmatter
One-click install
npx skills add https://github.com/petrSimonidesXart/xPmGateway --skill build-skills-index-petrsimonidesxart
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-skills-index
Source: https://github.com/petrSimonidesXart/xPmGateway/tree/main/.gaai/core/skills/cross/build-skills-index
Command: npx skills add https://github.com/petrSimonidesXart/xPmGateway --skill build-skills-index-petrsimonidesxart

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scans SKILL.md files across core and project skill trees to extract YAML frontmatter and regenerate separate indices, enabling fast, accurate discovery without relying on a single volatile source of truth.

Core Features & Use Cases

  • Scan both core and project skill directories for SKILL.md and collect frontmatter.
  • Validate required fields and log warnings for missing ones without skipping.
  • Generate and maintain two indices at .gaai/core/skills/skills-index.yaml and .gaai/project/skills/skills-index.yaml.
  • Report duplicates across layers and missing fields to prevent silent conflicts.

Quick Start

Invoke the build-skills-index skill to regenerate the core and project skills indices.

Frequently Asked Questions about build-skills-index

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

FAQPage Schema
How do I generate a skill index from YAML frontmatter in multiple project directories?▼

To generate a skill index from YAML frontmatter, scan SKILL.md files across core and project directories to extract metadata and output separate index caches for each layer.

What happens when a SKILL.md file is missing required frontmatter fields during indexing?▼

When required frontmatter fields are missing during indexing, the skill logs a warning but still includes the entry in the generated index without skipping it.

Can I detect duplicate skill IDs across core and project directories?▼

Yes, you can detect duplicate skill IDs across core and project directories; the indexing process reports cross-layer ID conflicts to prevent silent discovery errors.

How does separating core and project skill catalogs improve discovery?▼

Separating core and project skill catalogs builds independent indices at .gaai/core and .gaai/project, ensuring fast and accurate discovery without relying on a single volatile source of truth.

Do I need any external dependencies to scan directories and build a skills index?▼

No external dependencies are required to scan directories and build a skills index; the framework processes SKILL.md files and outputs YAML caches natively without additional tools.

Related Skills

Explore More Software Engineering Skills→
nicholasgriffintnnicholasgriffintn
2

add-skill

Create and validate SKILL.md files with YAML frontmatter for OpenCode or Claude.

Community
Basic
Fr-e-dFr-e-d
157

build-skills-indices

Scan SKILL.md files and regenerate a unified YAML skills index.

Community
Basic
mkurmanmkurman
321

using-superpowers

Invoke the Skill tool at conversation start to discover and route applicable skills.

Community
Intermediate
sanity-iosanity-io
173

sanity-best-practices

Scan directory roots for SKILL.md files and extract YAML frontmatter metadata.

Official
Basic