grimoire — Claude Code skill: what it does, how to install
This skill helps create and check .spell files, run Grimoire strategies, and debug CLI failures. Use it for validate, simulate, advisory, and cast workflows.
npx skills add franalgaba/grimoire --skill grimoire -a claude-codeWhat grimoire does
grimoire gives an agent a working procedure for Grimoire, from CLI setup and .spell authoring to format, compile, validate, simulate, cast, and resume. It points syntax and flag work to bundled reference files, with separate guidance for advisory decisions and replay runs.
The CLI can run through a global install, npx -y @grimoirelabs/cli, or the repo-local Bun command bun run packages/cli/src/index.ts --. The skill covers venue checks, RPC and signer diagnostics, wallet commands, and cross-chain options. Irreversible actions require cast --dry-run first, followed by explicit confirmation before a live cast.
Setup data may be written to .grimoire/setup.env as plaintext secret material, so keep that file local. Passwords and private keys must stay out of agent prompts and inline command assignments.
What it helps with
- author or edit a
.spellfile - validate a spell and fix its warnings
- replay an advisory run by
runId - simulate a strategy on a chain
- check RPC, signer, or venue readiness
Example prompts for the agent
- Create
spells/strategy.spell, format it, and runvalidateon the result. - Simulate this strategy on chain
1, then prepare a safe dry run. - Diagnose the
venue doctorfailure for the current adapter and suggest a fix.
How to install grimoire
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire -a claude-code2Manually: put the files in place
~/.claude/skills/grimoire/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grimoire/
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire -a codex2Manually: put the files in place
.agents/skills/grimoire/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire -a cursor2Manually: put the files in place
.cursor/skills/grimoire/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franalgaba/grimoire grimoire2Manually: put the files in place
.github/skills/grimoire/SKILL.md1Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire -a gemini-cli2Platform CLI
gemini skills install https://github.com/franalgaba/grimoire --path skills/grimoireManually: put the files in place
.devin/skills/grimoire/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add franalgaba/grimoire --skill grimoire -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about grimoire
How do I install grimoire in Claude Code?
Run npx skills add franalgaba/grimoire --skill grimoire -a claude-code, then check ~/.claude/skills/grimoire/SKILL.md.
What does the grimoire skill do?
It helps install and operate Grimoire, author .spell files, check their syntax, simulate runs, and follow safety checks around CLI execution.
What is required to run grimoire?
Use one of these execution paths: a global grimoire CLI, npx -y @grimoirelabs/cli, or repo-local Bun execution. Live operations also need suitable RPC and signer state.
