zensical

Migrate mkdocs-material projects to Zensical and manage their documentation.

Updated Apr 3, 2026

Search Tags:#theming #documentation #markdown #static-site-generator #github-pages #zensical #mkdocs-migration

One-click install

npx skills add https://github.com/kettleofketchup/KettleOfSkills --skill zensical

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: zensical
Source: https://github.com/kettleofketchup/KettleOfSkills/tree/main/plugins/zensical/skills/zensical
Command: npx skills add https://github.com/kettleofketchup/KettleOfSkills --skill zensical

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the friction of creating, customizing, and maintaining static documentation sites with Zensical, including migrating existing projects from mkdocs-material to the new TOML-based configuration system.

Core Features & Use Cases

Project Setup & Configuration: Bootstrap new Zensical projects, configure zensical.toml settings, enable Markdown extensions, and choose between modern or classic theme variants.
Content Authoring: Create rich documentation with admonitions, syntax-highlighted code blocks, content tabs, responsive grids, icons, Mermaid diagrams, and math rendering.
Publishing & CI/CD: Deploy documentation to GitHub Pages or GitLab Pages, and integrate Zensical build steps into existing CI/CD pipelines.
Use Case: A developer maintaining an open source project's documentation can use this Skill to migrate an existing mkdocs-material site to Zensical, add custom branding and interactive content, and set up automated publishing on every push to the main branch.

Quick Start

Use the zensical skill to migrate your existing mkdocs.yml configuration to zensical.toml and set up a GitHub Pages deployment workflow for your documentation project.

Frequently Asked Questions about zensical

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I migrate an existing mkdocs-material site to Zensical?▼

Zensical supports deploying static documentation sites to GitHub Pages or GitLab Pages by integrating build steps into your CI/CD pipelines, enabling automated publishing on every push to your main branch.

How do I configure zensical.toml for a new documentation project?▼

You can configure zensical.toml during project initialization by defining settings, enabling Markdown extensions, and selecting modern or classic theme variants to customize your static documentation site.

Does Zensical support advanced Markdown authoring like Mermaid diagrams and admonitions?▼

Zensical supports advanced Markdown authoring including admonitions, syntax-highlighted code blocks, content tabs, responsive grids, icons, Mermaid diagrams, and math rendering for rich documentation.

What is the best way to deploy static documentation to GitHub Pages using Zensical?▼

Zensical supports deploying static documentation sites to GitHub Pages or GitLab Pages by integrating Zensical build steps into your existing CI/CD pipelines for automated publishing.