hugo-runner
Helper utility for running the Hugo static site generator and testing local changes.
Install
mkdir -p .claude/skills/hugo-runner && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/4958" && unzip -o skill.zip -d .claude/skills/hugo-runner && rm skill.zipInstalls to .claude/skills/hugo-runner
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Guide for running Hugo static site generator. This skill should be used when users want to test changes.Key capabilities
- →Manages Hugo versioning per directory
- →Launches local dev server with custom port mapping
- →Monitors build warnings and error logs
- →Previews site content in real-time during development
How it works
Wraps Hugo CLI commands with environment-specific context and version switching logic.
Inputs & outputs
When to use hugo-runner
- →Start local Hugo dev server
- →Preview site content changes
- →Verify build configurations
- →Switch Hugo versions
About this skill
Hugo
Overview
Hugo converts source files from content formats to output formats. In production it only creates files. For development it has an integrated webserver.
The conversion from content to output is controlled by configuration and template files.
The docs are at https://gohugo.io/documentation/
Preparation Before Run
-
If a specific Hugo version is required use hvm to install it in the working directory; this also applies to version keywords like
latest,oldest,minimallatestis supported byhvm. If the user requiersoldestorminimal, look intotheme.tomlundermodule.hugoVersion.min:hvm use latest- Use the latest Hugo versionhvm use 0.141.0- Use a specific version if minimal version is 0.141.0
Usage
Run the webserver for testing changes.
Run the Webserver
Run the webserver on Hugo's on a non-default port of 3131.
cd <directory-of-content-directory> && hugo server -p 3131
To run Hugo on the default port 1313 (which is often blocked)
cd <directory-of-content-directory> && hugo server
Parameters Help
If you need a full understanding of all available parameters
hugo help
Usage Notes
- Always run Hugo from inside the working directory
- Access the site at http://localhost:3131
- The files that Hugo generates and afterwards serves are stored in
publicof the working directory - Source Markdown files of
content/*can be accessed as their output representation byhttp://localhost:3131/*orpublic/* - Press Ctrl+C to stop the server
- Watch stdout/stderr for build warnings and errors
When not to use it
- →Managing non-Hugo static site generators
- →When local server hosting is blocked by network policy
Prerequisites
Limitations
- →Requires explicit directory navigation for local execution
- →Build errors can occasionally crash the dev server process
How it compares
Simplifies version management and port conflicts that typically require manual configuration management.
Compared to similar skills
hugo-runner side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| hugo-runner (this skill) | 1 | 6mo | No flags | Beginner |
| build-macos-apps | 70 | 8mo | Review | Intermediate |
| cloudflare-manager | 25 | 9mo | Review | Intermediate |
| railway-cli-management | 9 | 8mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
build-macos-apps
glittercowboy
Build professional native macOS apps in Swift with SwiftUI and AppKit. Full lifecycle - build, debug, test, optimize, ship. CLI-only, no Xcode.
cloudflare-manager
qdhenry
Comprehensive Cloudflare account management for deploying Workers, KV Storage, R2, Pages, DNS, and Routes. Use when deploying cloudflare services, managing worker containers, configuring KV/R2 storage, or setting up DNS/routing. Requires CLOUDFLARE_API_KEY in .env and Bun runtime with dependencies installed.
railway-cli-management
CaptainCrouton89
Deploy, manage services, view logs, and configure Railway infrastructure. Use when deploying to Railway, managing environment variables, viewing deployment logs, scaling services, or managing volumes.
unity-editor-toolkit
Dev-GOM
Automate and control Unity Editor with 500+ commands, real-time WebSocket communication, and SQLite integration for efficient game development.
miniprogram-development
TencentCloudBase
WeChat Mini Program development rules. Use this skill when developing WeChat mini programs, integrating CloudBase capabilities, and deploying mini program projects.
azure-functions
aj-geddes
Create serverless functions on Azure with triggers, bindings, authentication, and monitoring. Use for event-driven computing without managing infrastructure.