This is a comprehensive guide for spinning up Hugo sites without the usual config headaches. It walks you through the Extended vs Standard edition trap (most themes need Extended for SCSS support), sets you up with YAML configs for CMS compatibility, and includes actual working examples for PaperMod integration, Tailwind CSS v4 setup, and Cloudflare Workers deployment. The author clearly got burned by the common pitfalls because there are warnings everywhere about Git submodules, baseURL misconfiguration, and TOML vs YAML issues. Covers both quick blog setups and more complex scenarios like headless CMS integration with Sveltia or Tina. If you're tired of Hugo's cryptic error messages, this will save you hours.
- skills.sh installs
- 184
- GitHub stars
- 16
- last updated
- Jun 3, 2026
Install
$ npx -y skills add jackspace/claudeskillz --skill hugo --agent claude-codeInstalls into .claude/skills of the current project.
Files
Hugo Static Site Generator
Status: Production Ready Last Updated: 2025-11-04 Dependencies: None (Hugo is a standalone binary) Latest Versions: hugo@0.152.2+extended, PaperMod@latest, Sveltia CMS@latest
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.
# macOS
brew install hugo
# Linux (Ubuntu/Debian)
wget https://github.com/gohugoio/hugo/releases/download/v0.152.2/hugo_extended_0.152.2_linux-amd64.deb
sudo dpkg -i hugo_extended_0.152.2_linux-amd64.deb
# Verify Extended edition
hugo version # Should show "+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
# Use YAML format (not TOML) for better CMS compatibility
hugo new site my-blog --format yaml
# Initialize Git
cd my-blog
git init
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/jackspace/claudeskillz
- First seen
- Jun 3, 2026
