skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
mathews-tom/armory89 installs

skill-library

Agent-native armory catalog for eight package types and installer for seven legacy types. Native extensions require the explicit per-host lifecycle CLI. Triggers on: "list available packages", "install skill", "armory install", "armory search", "/library list", "package catalog".

How do I install this agent skill?

npx skills add https://github.com/mathews-tom/armory --skill skill-library
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill functions as a package manager for the agent, allowing it to discover and install various extensions from a remote GitHub repository. It employs standard shell tools for file management and includes specific policies to prevent the automatic installation of more privileged 'native extensions.' The primary security consideration is the ingestion of external data which serves as a potential vector for indirect prompt injection.

  • Socketwarn

    2 alerts: gptAnomaly

  • Snykwarn

    Risk: MEDIUM · 2 issues

What does this agent skill do?

Package Library

Browse and search all armory package types within an agent session. Install, update, sync and remove the seven legacy package types through their existing procedures; native extensions use the separate explicit per-host lifecycle.

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

TypeInstall TargetMethod
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
extensionExplicit per-host rootNative lifecycle CLI only

Command Reference

CommandCookbookPurpose
/library listcookbook/list.mdShow all packages with type, version, installed status, update available
/library list --type <type>cookbook/list.mdFilter listing by package type (skill, agent, hook, rule, etc.)
/library use <name>cookbook/use.mdPull a package from armory (auto-detects type from manifest)
/library search <keyword>cookbook/search.mdKeyword search across all package types, names, and descriptions
/library search --category <name>cookbook/search.mdFilter search by category (development, review, security, etc.)
/library synccookbook/sync.mdRe-pull all installed packages that have updates
/library info <name>cookbook/info.mdShow full detail for a package (type, version, tags, category)
/library updatecookbook/update.mdCheck all installed packages for version bumps (dry-run sync)
/library remove <name>cookbook/remove.mdRemove an installed package
/library profilescookbook/profiles.mdShow 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.

Native Extension Boundary

This boundary takes precedence over the legacy cookbook procedures.

  • Identify the type from the matching manifest section before inspecting an installed path or fetching package files. Catalog inspection may fetch the manifest; it must not fetch or copy a native extension payload.
  • For native catalog queries, read packages.extensions and show catalog metadata. Do not derive native installed status from ~/.claude/skills/, the legacy plugin inventory or any other prompt-package directory; report that native installation status was not inspected.
  • Refuse /library use, sync, update or remove filesystem operations on an extension. Never copy native artifacts into skills, agents or other legacy directories, never enable one implicitly, and never treat a profile or preset as native-install authority.
  • After the user explicitly confirms the native host, lifecycle action and target root, hand off to uv run python scripts/install.py in an existing Armory checkout with every native flag explicit: --type extension --platform <omp|claude> --name <name> --action <install|update|disable|remove> --target-root <explicit-root> --yes. Never supply --yes before that confirmation. Do not select a host or persistent root on the user's behalf, or execute the handoff as part of a legacy library operation.
  • Native entries remain discoverable in the catalog but never contribute to legacy profile membership or package counts. For bulk legacy operations, exclude packages.extensions before expanding the selection.

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.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/mathews-tom/armory/skill-library">View skill-library on skillZs</a>