grimmory-self-hosted-library skill — Claude Code guide
Helps AI agents configure and run the self-hosted Grimmory book manager in Docker, set up e-reader sync, and extend its Spring Boot backend.
npx skills add reason-machines/trending-skills --skill grimmory-self-hosted-library -a claude-codeWhat grimmory-self-hosted-library does
This skill equips your coding agent with setup recipes for Grimmory, a personal library server replacing BookLore. It covers building the docker-compose.yml file alongside MariaDB, mapping persistent storage volumes, and configuring environment parameters.
The guide details auto-import routines via the BookDrop folder, metadata fetching from public registries, and syncing with Kobo and KOReader hardware. Setting DISK_TYPE=NETWORK prevents accidental file deletion or renaming whenever books sit on shared SMB or NFS volumes.
For backend development, the instructions document the /api/v1/ REST interface and common Spring Boot patterns. You will need Docker and Docker Compose installed locally, because the instructions rely strictly on container execution.
What it helps with
- deploy Grimmory and MariaDB containers via Docker Compose
- configure the BookDrop folder for automatic ebook ingest
- link KOReader and Kobo devices through OPDS and sync endpoints
- protect SMB or NFS storage against deletions via
DISK_TYPE=NETWORK - build custom Java endpoints against the Grimmory REST API
Example prompts for the agent
- Generate a docker-compose.yml and .env setup for Grimmory with MariaDB
- How do I configure BookDrop auto-import and OPDS in Grimmory?
- Write a Spring Boot controller for the Grimmory API to manage shelves
How to install grimmory-self-hosted-library
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill grimmory-self-hosted-library -a claude-code2Manually: put the files in place
~/.claude/skills/grimmory-self-hosted-library/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grimmory-self-hosted-library/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill grimmory-self-hosted-library -a codex2Manually: put the files in place
.agents/skills/grimmory-self-hosted-library/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill grimmory-self-hosted-library -a cursor2Manually: put the files in place
.cursor/skills/grimmory-self-hosted-library/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills grimmory-self-hosted-library2Manually: put the files in place
.github/skills/grimmory-self-hosted-library/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill grimmory-self-hosted-library -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/grimmory-self-hosted-libraryManually: put the files in place
.devin/skills/grimmory-self-hosted-library/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill grimmory-self-hosted-library -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 grimmory-self-hosted-library
How do I install grimmory-self-hosted-library in Claude Code?
Run npx skills add reason-machines/trending-skills --skill grimmory-self-hosted-library -a claude-code. You can also place the skill file manually at ~/.claude/skills/grimmory-self-hosted-library/SKILL.md.
What does the grimmory-self-hosted-library skill do?
It provides your coding assistant with environment variables, volume mount strategies, sync instructions, and Spring Boot API conventions for the Grimmory platform.
What does DISK_TYPE=NETWORK do in Grimmory?
It puts the system into a safe mode for mounted network drives like NFS or SMB, disabling deletion, move, and rename operations in the interface while leaving reading intact.