skill library

AI Community

Skill notes

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

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 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

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.

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: Resolve the correct source path: {type_dir}/{name}/ Determine the install target: ~/.claude/{install_subdir}/ Choose the install method: directory copy or body-only extraction

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
AI
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@Mathews-Tom · no license declared
Token usage
Lean
Setup complexity
Guided setup
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
Network behavior
External requests
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

# 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`.

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.