Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add grimoire-rs/grimoire --skill grim-authoringgit clone --depth 1 https://github.com/grimoire-rs/grimoireWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/grimoire-rs/grimoire/grim-authoring)<a href="https://agentmods.dev/skills/grimoire-rs/grimoire/grim-authoring"><img src="https://agentmods.dev/badge/skills/grimoire-rs/grimoire/grim-authoring/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/grimoire-rs/grimoire/grim-authoring"><img src="https://agentmods.dev/badge/skills/grimoire-rs/grimoire/grim-authoring.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00190 | $0.05173 |
| Opus 5.5 | $0.00076 | $0.02069 |
| Sonnet 5.5 | $0.00038 | $0.01035 |
| Haiku 4.5 | $0.00019 | $0.00517 |
Grade A, and why
grim-authoring scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 339 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Grim Artifact Authoring
Grim publishes six artifact kinds to OCI registries. Each has its own
source shape, frontmatter schema, and validation gates. This root file
holds the invariants that apply to every kind; per-kind depth lives in
references/, loaded via the routing table below.
The Six Kinds
grim build and grim release infer the kind from the path — except
agents (always --kind agent, or they silently pack as rules) and MCP
servers (always --kind mcp, or the .toml is treated as a bundle).
| Kind | Source shape | Inference | Installs as |
|---|---|---|---|
| Skill | Directory with a SKILL.md index |
directory → skill | Directory tree under the client's skills/ dir |
| Rule | Single .md file |
.md → rule |
rules/<name>.md, per-client transform |
| Rule + support dir | <name>.md + sibling <name>/ dir |
sibling dir auto-discovered | Index file + rules/<name>/… side by side |
| Agent | Single .md, frontmatter required |
never — --kind agent mandatory |
One agent file per client, per-client render |
| MCP server | .toml descriptor with a [server] table |
never — --kind mcp mandatory |
Entry in each client's MCP config file, per-client render |
| Hook | Directory with a hook.toml manifest + its payload files |
directory with hook.toml → hook |
Payload tree materialized once per scope, one recorded output per client. Arming is gated and off by default — see hook-spec.md |
| Bundle | .toml member list |
.toml → bundle |
Never materializes — expands to its members |
A skill directory or a rule's support directory can drop a .grimignore
at its root (gitignore syntax) to keep runtime junk — __pycache__/,
.venv/, .DS_Store — out of the pack and out of drift detection; a
built-in default list already covers the common cases and .grimignore
lines extend it; a !pattern line re-includes a default. SKILL.md, a rule's index, a hook's hook.toml, and .grimignore
itself are never ignorable. A hook handler naming an ignored file fails
grim build (65) — it would never be packed; its runtime byproducts
beyond the defaults belong in .grimignore, or they read as drift. Agents get no .grimignore — their companion
directory is already an allowlist. Full default list and semantics:
[Artifact Reference § .grimignore][grimignore].
What ships with it
12 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- references/agent-spec.md 9.0 KB
- references/bootstrap-existing-repo.md 7.2 KB
- references/bundle-spec.md 7.2 KB
- references/hook-spec.md 27 KB
- references/hosting-a-marketplace.md 20 KB
- references/hosting-an-index.md 9.5 KB
- references/mcp-spec.md 11 KB
- references/release-checklist.md 18 KB
- references/rule-spec.md 8.9 KB
- references/skill-spec.md 9.6 KB
- references/updating.md 5.6 KB
- references/vendor-metadata.md 8.1 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago Changed · +21 lines · +28 tokens per session 9b8101bf547f
- 21d ago Changed · +93 lines · +21 tokens per session b2da67949c71
- 28d ago Changed · +15 lines 655287cb7fd9
- 1mo ago Changed · +3 tokens per session 1b5ff44bbfa8
- 1mo ago First seen · 210 lines · 138 tokens per session scan A 0d4fecc7b115
grim-authoring is a skill published in the GitHub repository grimoire-rs/grimoire (14 stars, last pushed today), licensed Apache-2.0. It adds 190 tokens to every session and 5,173 once invoked, about $0.0008 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
vuln-scanner
Audit trending repos for real security vulnerabilities and disclose responsibly - scan and route findings (PVR / dependency PR), re-submit queued advisories, and send armed email disclosures.
fork-fleet
Fork divergence monitor - tracks where the fleet's active forks diverge in CODE (unique commits, new/modified skills) and CONFIG (enable/var/model/schedule vs upstream), gated on real change.
pack-submit
Package one of this agent's own skills as a standalone community pack and submit it to the aeon registry as a PR.
shiplog
Recap of everything shipped since the last run - cross-repo PRs, security fixes, star deltas, and X traction, synthesized into a digest article and a ready-to-post shiplog in your voice.
token-pick
One token recommendation and one prediction market pick - scored, quantified, with a skip branch when signals are weak.
autoresearch
Evolve a skill by generating variations, evaluating them, and updating the best version.