Hugo Runner
Testing & Qualityhugo-runnerHugo Runner is an Agent Skill for testing & quality published in the McShelby/hugo-theme-relearn repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Guide for running Hugo static site generator. This skill should be used when users want to test changes.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/McShelby/hugo-theme-relearn/blob/HEAD/.claude/skills/hugo/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/hugo-runner, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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