Agent skill · magnus919
hugo-theme
Build, customize, and debug advanced Hugo CMS themes — template architecture, asset pipeline (CSS/JS/image processing), shortcodes and render hooks, page bundles, cover images, Hugo Modules, performance, SEO, and CI/CD. Use when working on a Hugo theme or site template layer.
What it needs
About 3k tokens when loaded.
What this skill does
Hugo Theme Development Intermediate-to-advanced patterns for Hugo CMS theme development. Load the relevant reference file for your task. Reference Files Topic Hugo Min Load when... File ------- ---------- ------------- ------ Template Architecture v0.120+ You need to set up base templates with blocks, understand template lookup order (kind/layout/type/section), create partials, use partial decorators (v0.154+), or work with shortcode fundamentals references/template-architecture.md Asset Pipeline v0.161+ You're integrating Tailwind CSS v4 (css.TailwindCSS) or v3 (PostCSS), using Hugo Pipes for SCSS/JS bundling, setting up fingerprinting and SRI, building responsive images with srcset, or processing page/global/remote resources references/asset-pipeline.md Shortcodes & Render Hooks v0.112+ You need complex nested shortcodes, raw HTML shortcodes, markdown rendering inside shortcodes, custom render hooks for links/images/headings/code blocks, or language-specific code block rendering (Mermaid, etc.) references/shortcodes-and-hooks.md Content Organization & i18n v0.126+ You're working with leaf vs branch bundles, headless bundles, cover images, custom taxonomies, content adapters (v0.126+, dynamic pages), section-specific layouts, archetypes, or internationalization (translation tables, multilingual) references/content-and-i18n.md Cover Images v0.120+ You need to add cover/hero images to articles, support both page bundle resources and frontmatter paths, generate responsive srcsets, or handle the no-cover case gracefully references/cover-images.md Modules & Performance v0.109+ You're using Hugo Modules (init, import, vendor, workspace), building theme components with mount configuration, optimizing build speed with partialCached, configuring cache TTLs, or using configuration-driven theming (params, cascade) references/modules-and-performance.md Design, UX & Accessibility v0.120+ You need typography systems, accessible color palettes, design tokens, semantic HTML landma …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills magnus919/hugo-theme