---
name: moaa-catalog
description: Find and use a skill from an installed but disabled plugin when the task needs a capability none of the listed skills cover (a framework, file format, cloud service or workflow), or when a moaa-catalog hook note names one. Search first; never enable plugins just to look.
---

# MOAA catalog: skills on demand

MOAA installs big skill packs (agentic-awesome-skills, ruflo extras) disabled, so their skills are not listed in every
request. Their files stay on disk, indexed in `~/.claude/moaa-catalog/index.json` (rebuilt only when plugins or
settings change; a search takes milliseconds).

1. A hook may already have named matches for the user's prompt ("moaa-catalog: skills from disabled plugins...").
   Otherwise search with 1 to 4 specific words:

   ```
   python "${CLAUDE_PLUGIN_ROOT}/catalog.py" search <words>
   ```

2. Load the best match into this session with one call, which also logs the use:

   ```
   python "${CLAUDE_PLUGIN_ROOT}/catalog.py" use "<path to its SKILL.md>"
   ```

   Follow what it prints for this task. Files it mentions sit next to that SKILL.md.
3. Only skills work this way. When a pack's hooks, agents or MCP tools are needed, or `use` reports the pack is used
   often, tell the user and run `claude plugin enable <plugin id>` (loads from the next session). For one project
   only, add `"enabledPlugins": {"<plugin id>": true}` to that project's `.claude/settings.json`.

`catalog.py packs` lists the disabled plugins with their skill counts. Nothing here changes settings or plugins.