grim-usagelisted

# Grim Usage Grimoire (binary: `grim`) is a package manager for AI-agent configuration. It distributes five artifact kinds — **skills**, **rules**, **agents**, **MCP servers**, and **bundles** — through any standard OCI registry (GHCR, Docker Hub, a private Distribution), with lockfile-pinned installs into a growing fleet of AI clients plus a vendor-neutral `agents` target. The current names are listed in [references/registries.md](references/registries.md#client-targets); the set grows every minor release, so read it there rather than assuming. An MCP server artifact installs by registering an entry in each client's native MCP config file (never as a file of its own); uninstall removes only that entry, never the file. Not every client can host every kind: a **skill** is the one kind every client hosts, but a rule needs a per-file scoping surface, an agent needs a shipped file format, and an MCP server needs a config file grim can splice — and many clients lack one or more of those. Where a client cannot faithfully host a kind, grim warns and skips it, writing zero files. Most of the fleet declines rules and agents, and the skills-only clients write no MCP config at all. The authoritative per-client support matrix is the [Client Compatibility][clients] docs page — trust it over this summary, and check it rather than assuming. Two consequences of that shape are worth knowing before your first install. When **nothing** is detected, grim targets the generic `agents` client —