메뉴
Zensical static site generator (successor to mkdocs-material). This skill should be used when authoring docs, writing zensical.toml, running uv/Docker preview, theming, or publishing to Pages.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | zensical |
| last_updated | "2026-03-25T00:00:00.000Z" |
| version | 0.0.x (alpha) |
| description | Zensical static site generator (successor to mkdocs-material). This skill should be used when authoring docs, writing zensical.toml, running uv/Docker preview, theming, or publishing to Pages. |
Modern static site generator by the makers of Material for MkDocs. Written in Rust and Python, published as a Python package. Uses zensical.toml (TOML) for configuration instead of mkdocs.yml (YAML), though legacy YAML is supported for migration.
| Topic | Reference |
|---|---|
| Installation (pip, uv, Docker) | installation.md |
Project config (zensical.toml, extensions) | project-config.md |
| Dev workflow (serve, build, CLI) | dev-workflow.md |
| Publishing (GitHub/GitLab Pages) | publishing.md |
| Navigation & site search | navigation-search.md |
| Theming & customization | theming.md |
For CI/CD pipeline details, reference the /github or /gitlab-ci skills.
| Topic | Reference |
|---|---|
| Admonitions (callouts) | admonitions.md |
| Code blocks & content tabs | code-blocks-tabs.md |
| Grids (card & generic) | grids.md |
| Text formatting & buttons | formatting-text.md |
| Images, icons, diagrams, math | media-diagrams.md |
| Front matter, tags, tables, lists, footnotes, tooltips | metadata-elements.md |
| Topic | Reference |
|---|---|
| Content reuse (Snippets, include-markdown substitute) | content-reuse.md |
| API documentation (mkdocstrings) | mkdocstrings.md |
Config conversion from mkdocs.yml to zensical.toml, feature parity status, extension compatibility, theme overrides, analytics, and plugin substitutes.
zensical.toml) instead of YAML (mkdocs.yml)[project]modern (new) or classic (Material-compatible)lucide/ by default (also supports fontawesome, material, octicons, simple-icons)[project.markdown_extensions.<name>] TOML tables[project.plugins.<name>] TOML tableszensical new, zensical serve, zensical buildlocalhost:8000pymdownx.snippets replaces mkdocs-include-markdown for content reusemkdocs-macros has no direct substitute; Zensical is developing a module systemReviews code comments across languages before a PR opens. Use when finishing a development branch, before merging, or when a pr create was blocked pending comment review.
Create, promote, categorize, and validate skills for the kettleofskills marketplace. Use when syncing dotfiles skills into the marketplace, adding skills, assigning categories, or preparing a release.
Docker builds, Compose, and Docker-in-Docker for CI. Use when writing Dockerfiles, optimizing build times, multi-stage builds, BuildKit cache mounts, docker-compose.yml, or CI/CD pipelines (GitHub/GitLab/Forgejo Actions) — including docker-in-docker (dind) runners, rootless dind, bind-mount-vs-build-context confusion, and "mkdir <path>: permission denied" mount failures. Covers layer ordering, dependency caching, .dockerignore, multi-stage, BuildKit, Compose, and dind mount patterns.
Create or update Claude skills. Use for new skills, skill references, skill scripts, optimizing existing skills, extending Claude's capabilities.
Build Go terminal UIs (TUIs) and CLIs with charmbracelet — Bubble Tea runtime, Lip Gloss styling, Bubbles components, Glamour markdown, Harmonica animation, BubbleZone mouse. For any bubbletea TUI.
Bun SQL-first ORM for Go (uptrace/bun). Use for PostgreSQL/SQLite setup, bun.BaseModel struct tags, query builder CRUD, relations, migrations, fixtures, hooks, transactions, and soft deletes.