Skip to content
cccskills
FreePublished on GitHub

hugo-template-guidance

Use this skill to understand and customize a Hugo theme or site. It directs you to guidance for page creation, content, configuration, components, modules, scripts, architecture, and styling, so you can follow the project’s documented approach.

OriginalShow the original description

Use whenever you need to understand how this theme works — adding pages, managing content, configuring the site, using partials/components/modules, project architecture, scripts, or styling/theming (Tailwind v4, Bootstrap 5, or a hybrid — verify which). Use for ANY question about the structure, usage, or customization of the template or theme.

zeon-studio/hugoplate1,595 stars(GitHub 1,595 + cccskills 0)

Run score Not tested

See how to install

Good for

  • Adding a page or homepage section
  • Managing Markdown content and frontmatter
  • Configuring menus, languages, or SEO
  • Finding the right theme component or module
  • Changing styles after checking the setup

Files included (12)

  • SKILL.md2.7 KB
  • references/adding-new-pages.md6.1 KB
  • references/component-usage.md4.8 KB
  • references/content-management.md2.3 KB
  • references/detect-mode.md2.2 KB
  • references/hugo-modules.md2.5 KB
  • references/i18n-guidance.md1.6 KB
  • references/page-configuration.md2.2 KB
  • references/preflight-checks.md1.1 KB
  • references/project-architecture.md3.5 KB
  • references/script-usage.md2.6 KB
  • references/styling-and-theming.md4.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Template Guidance

Handbook for this theme (Hugo Extended + Hugo Modules; styling is Tailwind v4, Bootstrap 5, or a hybrid — verify before assuming), assuming the standard project-setup layout (site at root, theme vendored in themes/<theme>/ — the single folder under themes/; see references/detect-mode.md to find its name). Progressive disclosure: read the matching references/ file before acting.

If exampleSite/hugo.toml exists, the repo is still in theme-setup — run <pm> project-setup first (see references/detect-mode.md) before using anything below.

Package manager: <pm> is a placeholder for this project's package manager. Detect it from a lock file (pnpm-lock.yaml, package-lock.json, yarn.lock, bun.lock/bun.lockb) or package.json's packageManager field before running any command below — don't assume pnpm. Details: references/script-usage.md.

Routing Guide

RequestRead
Detect or convert setup mode (theme-setup vs project-setup)references/detect-mode.md
pre-flight checks (Node, Hugo version, package manager)references/preflight-checks.md
Architecture, folder layout, data flowreferences/project-architecture.md
Add a page, route, or homepage sectionreferences/adding-new-pages.md
Partials, components, shortcodes, Hugo Modulesreferences/component-usage.md
Add, remove, or enable a Hugo Module (module.toml)references/hugo-modules.md
Markdown content, frontmatter, taxonomiesreferences/content-management.md
Add/configure a new language, multilingual, i18n, translatereferences/i18n-guidance.md
Site config, menus, social, feature toggles, SEOreferences/page-configuration.md
Package manager detection, scripts, generators, module updatesreferences/script-usage.md
Styling/theming (Tailwind v4, Bootstrap 5, or hybrid — verify first), dark mode, design tokensreferences/styling-and-theming.md

Steps

  1. Read the matching reference.
  2. Follow it.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

find-skills

FreeSummary

Find agent skills for a task or field, check their source and usage signals, and explain what each candidate does and how to install it. It can also suggest a custom skill or offer to handle the task directly when a search finds no match.

  • Looking for a skill for a specific task
  • Finding tools or workflows in a domain
  • Checking a candidate skill before installing
zeon-studio/hugoplate1.6KUpdated Oct 26, 2026

See all skills by zeon-studio

Report a problem with this skill