Skip to main content
skill CX Codex

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.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/trending-skills --skill grimmory-self-hosted-library -a claude-code
Open on GitHub

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

2Manually: put the files in place

~/.claude/skills/grimmory-self-hosted-library/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/grimmory-self-hosted-library/

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.

Similar skills

All skills for DevOps and infrastructure →

From the same set139

openmaic-classroom A skill that generates interactive lessons: slides, quizzes, simulations and project work come out of a multi-agent pipeline. Useful when you need a course from a topic or document. CX Codex +1 1,400installs cmux-terminal-multiplexer Equips AI agents with CLI commands for terminal split orchestration and headless Chromium browser actions via surface handles. CX Codex +1 1,400installs nightingale-karaoke This skill guides an agent through a Rust karaoke app with vocal separation, timed lyrics, player profiles, and pitch scoring. CX Codex +1 1,300installs kimodo-motion-diffusion A skill that wires the Kimodo kinematic diffusion model into your agent for 3D human and humanoid robot motion from text prompts and constraints. Expect roughly 17GB of VRAM. CX Codex +1 1,300installs taiwan-md-knowledge-base A skill for maintaining an open knowledge base about Taiwan built on Astro v5, with Chinese and English articles and a D3.js graph. Useful if you write or translate content for that project. CX Codex +1 1,300installs zeroboot-vm-sandbox This skill runs agent code inside a real KVM virtual machine through Zeroboot, forking a template in under a millisecond. CX Codex +1 1,300installs slug-font-rendering Provides reference HLSL shaders for GPU vector font rendering with the Slug algorithm. Useful for drawing glyphs at any scale without texture atlases. CX Codex +1 1,300installs memory-lancedb-pro-openclaw Guides setup of OpenClaw’s LanceDB memory plugin. Useful when an agent needs to retain project context between sessions or retrieve stored details. CX Codex +1 1,300installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor