build-skills-index

# Build Skills Index ## Purpose / When to Activate Activate when: - A new skill is created (invoked automatically by `create-skill` Step 6) - A skill's frontmatter is modified (description, tags, category, id) - A skill is removed or deprecated - Either `skills-index.yaml` is absent or suspected stale (e.g. after a git pull or framework update) This skill generates the derived catalogs used by agents for fast skill discovery. It does not replace frontmatter — it aggregates it. **`skills-index.yaml` files are caches. Frontmatter is the source of truth.** --- ## Process ### Step 1 — Scan both skill directories Scan `.gaai/core/skills/` recursively. Collect every file named `SKILL.md`. If `.gaai/project/skills/` exists, scan it too. Ignore non-SKILL.md files. Ignore `README.*`, `skills-index.yaml`. ### Step 2 — Extract frontmatter from each SKILL.md For each `SKILL.md` found, read the YAML frontmatter block (between `---` delimiters). Extract the following fields: | Field | Source | Notes | |---|---|---| | `name` | frontmatter `name` | Required | | `description` | frontmatter `description` | Required | | `id` | frontmatter `id` or `metadata.id` | Required | | `category` | frontmatter `category` or `metadata.category` | Required | | `track` | frontmatter `track` or `metadata.track` | Required | | `tags` | frontmatter `tags` or `metadata.tags` | May be absent — default to `[]` | | `updated_at` | frontmatter `updated_at` or `metadata.updated_at` | May be absent | | `path...