mathews-tom/skill-library

Package Library

Agent-native catalog and installer for all armory package types. Provides browsing, searching, installing, updating, syncing, and removing packages directly within an agent session.

Variables

• ARMORY_REPO: Mathews-Tom/armory
• ARMORY_BRANCH: main
• ARMORY_CATALOG_URL: https://raw.githubusercontent.com/{ARMORY_REPO}/{ARMORY_BRANCH}/manifest.yaml
• DEFAULT_INSTALL_DIR: ~/.claude/
• CATALOG_CACHE_PATH: /tmp/armory-manifest.yaml
• CATALOG_CACHE_TTL: 600 (seconds)

Supported Package Types

| Type | Install Target | Method | | ------- | ---------------------- | --------------- | | skill | ~/.claude/skills/ | Copy directory | | agent | ~/.claude/agents/ | Copy directory | | hook | ~/.claude/hooks/ | Copy directory | | rule | ~/.claude/rules/ | Body-only file | | command | ~/.claude/commands/ | Body-only file | | utility | ~/.claude/utilities/ | Copy + chmod +x | | preset | ~/.claude/presets/ | Copy directory |

Command Reference

| Command | Cookbook | Purpose | | ----------------------------------- | ---------------------- | ------------------------------------------------------------------------ | | /library list | cookbook/list.md | Show all packages with type, version, installed status, update available | | /library list --type <type> | cookbook/list.md | Filter listing by package type (skill, agent, hook, rule, etc.) | | /library use <name> | cookbook/use.md | Pull a package from armory (auto-detects type from manifest) | | /library search <keyword> | cookbook/search.md | Keyword search across all package types, names, and descriptions | | /library search --category <name> | cookbook/search.md | Filter search by category (development, review, security, etc.) | | /library sync | cookbook/sync.md | Re-pull all installed packages that have updates | | /library info <name> | cookbook/info.md | Show full detail for a package (type, version, tags, category) | | /library update | cookbook/update.md | Check all installed packages for version bumps (dry-run sync) | | /library remove <name> | cookbook/remove.md | Remove an installed package | | /library profiles | cookbook/profiles.md | Show available install profiles with package counts |

Cookbook Dispatch

User commands are routed to the corresponding cookbook file based on the subcommand. When a /library command is received, extract the subcommand (the first token after /library) and load the matching cookbook file from the cookbook/ directory relative to this skill. The cookbook file contains the full execution procedure for that operation.

For example, /library use commit-standards dispatches to cookbook/use.md with commit-standards as the package name argument. /library list --type agent dispatches to cookbook/list.md with --type agent as the filter.

If the subcommand does not match any known cookbook, report the error and list the valid subcommands from the table above.

Type Detection

When /library use <name> is called, determine the package type by searching all sections of the manifest (packages.skills, packages.agents, packages.hooks, etc.). The first section containing a matching name entry determines the type. Use the type to:

1. Resolve the correct source path: {type_dir}/{name}/
2. Determine the install target: ~/.claude/{install_subdir}/
3. Choose the install method: directory copy or body-only extraction

Behavioral Notes

• All bash operations must use absolute paths. Never cd into temp dirs.
• Fetch uses a 3-tier fallback chain: sparse checkout, then gh api, then curl. Attempt each in order; proceed to the next only on failure.
• Cache lives in /tmp/ with a 10-minute TTL. A missing cache file is treated as expired (triggers a re-fetch), not as an error.
• The catalog is read from manifest.yaml on GitHub (at ARMORY_CATALOG_URL), not from a separate catalog file. This is the same manifest format used by the armory repository.
• All package type sections share the same entry format: name, version, description, path, source, plus optional tags, category, difficulty.