Why does my Hugo site break when I add a custom mount?

When you define any custom mount in Hugo, the default directory mappings are replaced. You must explicitly include standard mounts for content, layouts, and static folders to keep the site functional.

Can I use this for monorepos?

Yes, this skill is specifically designed for monorepos where documentation is scattered across different service or tool subdirectories and needs to be aggregated into one site.

What are Hugo module mounts?

Hugo module mounts are configuration settings in hugo.toml that map arbitrary source directories into Hugo's virtual filesystem, allowing multiple folders to appear as one unified content tree.

Does this require Go to be installed?

Yes, Hugo's module system is built on Go modules, so you must have Go installed and have initialized your project with 'hugo mod init'.

Hugo Module Mounts

Name: Hugo Module Mounts
Author: therealbill

bytherealbill

0•

Content Management

Aggregates documentation from multiple directories into a unified Hugo site using module mounts and union file systems.

This skill provides Claude with the specialized knowledge to configure and manage Hugo's module mount system, enabling the creation of complex documentation sites from scattered source directories. It automates the setup of [[module.mounts]] in hugo.toml, ensuring that documentation co-located with source code in monorepos or plugin architectures is seamlessly merged into a single, cohesive site. By leveraging Hugo's union file system, the skill helps developers maintain decentralized content while providing a centralized user experience, all while avoiding common configuration pitfalls like missing standard mounts or module initialization errors.

Key Features

01Union file system management to prevent path conflicts

020 GitHub stars

03Automated [[module.mounts]] configuration for multi-directory sites

04Preservation of standard Hugo directory structures (layouts, assets, data)

05Monorepo documentation aggregation for services and plugins

06Validation of Go module requirements and initialization

Use Cases

01Consolidating docs/ folders from various microservices into a single documentation portal

02Building a plugin marketplace where docs are stored alongside plugin source code

03Sharing common layouts and assets across multiple Hugo projects within a repository

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add therealbill/mynet hugo-module-mounts

For use in Claude.ai and ChatGPT

Download Skill