meta-skill-indexer {Meta} (v1.0)

"Skills that create, review, search, and deploy other skills."

Purpose

Generates the skills_index.json catalog from SKILL.md frontmatter. Used by meta-skill-searcher for BM25 search. [EXPLICIT]

When to use: After creating, deleting, or modifying skills. Run python .agent/scripts/generate_index.py.

Core Principles

1. Law of Single Source: skills_index.json is auto-generated, never hand-edited. [EXPLICIT]
2. Law of Frontmatter: Index extracts: name, description, version, status, tags from YAML frontmatter. [EXPLICIT]
3. Law of Freshness: Re-index after any skill change. [EXPLICIT]

Core Process

Phase 1: Walk .agent/skills/ for all SKILL.md files.

Phase 2: Parse YAML frontmatter from each.

Phase 3: Write skills_index.json with id, path, name, description, version, status, tags.

Validation Gate

• Operation completed successfully
• skills_index.json updated if needed
• context.json reflects current state
• No stack violations (R-002, R-003)

4. Self-Correction Triggers

[!WARNING] IF skills_index.json is stale THEN regenerate before searching. IF deploying a skill with status != production THEN WARN user.

Usage

Example invocations:

• "/meta-skill-indexer" — Run the full meta skill indexer workflow
• "meta skill indexer on this project" — Apply to current context

Assumptions & Limits

• Assumes access to project artifacts (code, docs, configs) [EXPLICIT]
• Requires English-language output unless otherwise specified [EXPLICIT]
• Does not replace domain expert judgment for final decisions [EXPLICIT]

Edge Cases

Scenario	Handling
Empty or minimal input	Request clarification before proceeding
Conflicting requirements	Flag conflicts explicitly, propose resolution
Out-of-scope request	Redirect to appropriate skill or escalate