registry-loader

Registry Loader

Load the skill catalog for workflow building and skill discovery.

Purpose

Provides fast access to the skill catalog for the build pipeline. Uses the pre-compiled ~/.looplia/registry/skill-catalog.json instead of runtime scanning.

Behavior

1. Read the skill catalog from ~/.looplia/registry/skill-catalog.json
2. If catalog doesn't exist, return empty registry with instructions to run looplia registry sync
3. Return catalog data for skill-capability-matcher

Process

1. Load Skill Catalog

Read the skill catalog file:

cat ~/.looplia/registry/skill-catalog.json

Or use the Read tool to access the file directly.

2. Parse Catalog Data

The skill catalog contains:

{
  "compiledAt": "2026-01-04T12:00:00Z",
  "version": "1.0.0",
  "sources": [
    {
      "id": "official",
      "type": "official",
      "url": "https://github.com/memorysaver/looplia-core/releases/latest/download/registry.json",
      "enabled": true,
      "priority": 100
    }
  ],
  "skills": [
    {
      "name": "media-reviewer",
      "title": "Media Reviewer",
      "description": "Deep content analysis (structure, themes, narrative)",
      "plugin": "looplia-writer",
      "category": "analysis",
      "capabilities": ["content-analysis", "media-processing"],
      "tools": ["Read", "Grep", "Glob"],
      "model": "claude-haiku-4-5-20251001",
      "source": "local",
      "sourceType": "builtin",
      "installed": true,
      "installedPath": "/home/user/.looplia/looplia-writer/skills/media-reviewer"
    }
  ],
  "summary": {
    "totalSkills": 14,
    "byCategory": {
      "analysis": 3,
      "generation": 2,
      "assembly": 2,
      "validation": 1,
      "search": 1,
      "orchestration": 3,
      "utility": 2
    },
    "bySource": {
      "local": 14
    }
  }
}

3. Format for skill-capability-matcher

Transform the skill catalog into the format expected by skill-capability-matcher:

{
  "plugins": [
    {
      "name": "looplia-writer",
      "path": "~/.looplia/looplia-writer",
      "skills": [
        {
          "name": "media-reviewer",
          "description": "Deep content analysis (structure, themes, narrative)",
          "tools": ["Read", "Grep", "Glob"],
          "model": "haiku",
          "capabilities": ["content-analysis", "media-processing"],
          "installed": true
        }
      ]
    }
  ],
  "summary": {
    "totalPlugins": 2,
    "totalSkills": 14,
    "installedSkills": 14,
    "availableSkills": 0
  }
}

Output Schema

{
  "plugins": [
    {
      "name": "string",
      "path": "string",
      "skills": [
        {
          "name": "string",
          "description": "string",
          "tools": ["string"],
          "model": "string",
          "capabilities": ["string"],
          "installed": "boolean"
        }
      ]
    }
  ],
  "summary": {
    "totalPlugins": "number",
    "totalSkills": "number",
    "installedSkills": "number",
    "availableSkills": "number"
  }
}

Advantages over plugin-registry-scanner

Aspect	plugin-registry-scanner	registry-loader (v0.7.0)
Speed	Scans filesystem at runtime	Reads pre-compiled JSON
Sources	Local only	Official + third-party
Installation Status	Not tracked	Included in output
Third-party Skills	Not discovered	Included from remote registries

Usage

This skill is typically invoked as the first step in workflow building:

1. Load skill catalog (this skill)
2. Pass catalog to skill-capability-matcher
3. Use matched skills in workflow-schema-composer

Notes

• If skill catalog doesn't exist, advise user to run looplia registry sync
• Catalog is auto-synced on every looplia build command
• Includes installation status for each skill
• Third-party skills may show installed: false until installed via looplia skill add