Agent skill · software engineering · secondsky
hugo
Hugo static site generator with Tailwind v4, headless CMS (Sveltia/Tina), Cloudflare deployment. Use for blogs, docs sites, or encountering theme installation, frontmatter, baseURL errors.
Why this skill is useful
Adds specific commands and configurations for deploying Hugo with Tailwind and headless CMS that the AI wouldn't reliably generate on its own.
What it needs
Requires hugo installed locally. About 8k tokens when loaded. Last updated 2026-08-06. 204 stars on the source repository.
What this skill does
Hugo Static Site Generator Status: Production Ready Last Updated: 2026-08-03 Latest Version: hugo@0.164.0+extended Build Speed: <100ms --- Quick Start (5 Minutes) 1. Install Hugo Extended CRITICAL: Always install Hugo Extended edition (not Standard) unless you're certain you don't need SCSS/Sass support. Most themes require Extended. Why this matters: Hugo Extended includes SCSS/Sass processing Most popular themes (PaperMod, Academic, Docsy) require Extended Standard edition will fail with "SCSS support not enabled" errors Extended has no downsides (same speed, same features + more) 2. Create New Hugo Site CRITICAL: Use --format yaml to create hugo.yaml (not hugo.toml) YAML is required for Sveltia CMS and recommended for TinaCMS TOML has known bugs in Sveltia CMS beta Git submodules require --recursive flag when cloning later 3. Configure and Build --- Critical Rules Always Do ✅ Install Hugo Extended (not Standard) - required for SCSS/Sass support in themes ✅ Use YAML configuration (--format yaml) - better CMS compatibility than TOML ✅ Add themes as Git submodules - easier updates and version control ✅ Set correct baseURL - prevents broken asset links on deployment ✅ Pin Hugo version in CI/CD - prevents version mismatch errors between local and deployment ✅ Add public/ to .gitignore - build output should not be committed ✅ Use draft: false - drafts don't appear in production builds ✅ Clone with --recursive flag - ensures theme submodules are fetched ✅ Use relative paths for images - /images/photo.jpg not ../images/photo.jpg ✅ Test build before deploying - catch errors locally with hugo --minify Never Do ❌ Don't install Hugo Standard - most themes require Extended edition ❌ Don't use TOML config with Sveltia CMS - has known bugs, use YAML instead ❌ Don't commit public/ directory - it's generated output, not source code ❌ Don't use different Hugo versions - local vs CI/CD version mismatch causes errors ❌ Don't forget submodules: recursive - themes won't load in CI/CD …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills secondsky/hugo