Menu
Build the full Cadmus documentation website (mdBook + cargo doc + Storybook + Next.js). Use this when asked to build, preview, or update the documentation site.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Build Cadmus on Linux and macOS hosts using xtask. Use when asked how to compile, test, lint, or run the project locally.
Run clippy locally and report only issues in the current diff, matching the CI reviewdog flow. Use when asked how to lint changed code or get clippy feedback on a branch before pushing.
Regenerate `.sqlx/` cached metadata when adding or modifying `sqlx::query!`, `sqlx::query_as!`, or `sqlx::query_scalar!` macros.
Cross-compile Cadmus for Kobo e-reader devices (ARM Linux). Use this when asked to build a Kobo release, cross-compile for ARM, or prepare a device binary.
Check or apply rustfmt formatting across the workspace. Use this when asked to format code, check formatting, or fix rustfmt issues.
Regenerate the translations POT file after modifying English documentation sources. Use when docs/src/**/*.md files are changed.
| name | docs |
| description | Build the full Cadmus documentation website (mdBook + cargo doc + Storybook + Next.js). Use this when asked to build, preview, or update the documentation site. |
Always use cargo xtask docs to build documentation in this project.
# Build the complete documentation website
cargo xtask docs
# Build only the mdBook output (skips website build — faster for local preview)
cargo xtask docs --mdbook-only
The final website is written to website/out/.
The following tools must be on PATH (all provided by the devenv shell):
mdbookmdbook-mermaidnpm / nodecargogit