| name | hugo |
| description | review, design, scaffold, refactor, and troubleshoot hugo sites and themes. use when the user asks for hugo content structure, layouts, taxonomies, shortcodes, themes, assets, build configuration, multilingual publishing, or migration guidance.
|
Hugo
Use this skill to keep Hugo work grounded in maintainable architecture, predictable delivery, and framework-appropriate conventions.
Intent Router
| Need | Load |
|---|
| core conventions, structure, review priorities, and common red flags for Hugo | references/best-practices.md |
| setup, migration, testing, build, delivery, and day-two workflow guidance for Hugo | references/workflows.md |
Quick Start
- Confirm Hugo version and theme posture, content bundle strategy, multilingual or taxonomy needs, and deployment host and URL constraints.
- Identify whether the task is greenfield scaffolding, incremental refactoring, troubleshooting, migration planning, or code review.
- Apply the defaults in
references/best-practices.md before proposing custom architecture.
- Prefer the smallest change set that improves clarity, safety, operability, and long-term maintainability.
Workflow
- start from content ownership and URL strategy
- keep layouts layered and override-friendly
- document shortcode and taxonomy rules
- verify local preview and deploy output after structural changes
Typical Focus Areas
- Hugo version and theme posture
- content bundle strategy
- multilingual or taxonomy needs
- deployment host and URL constraints
Outputs to Prefer
- summarize theme, content-model, and deployment constraints first
- group findings by content bundles, layouts, shortcodes, taxonomies, and publishing flow
- protect URLs and editorial workflows during cleanup
First Response Pattern
- restate the Hugo version, theme posture, content-bundle model, and deployment URL constraints before suggesting changes
- anchor the plan at content ownership, layout override order, and URL strategy
- name the verification loop up front:
hugo server, hugo --gc --minify, and inspection of the affected generated URLs and assets
Common Requests
Review this Hugo site structure for content modeling, layouts, shortcodes, and build hygiene.
Help refactor a Hugo site toward clearer content bundles and easier theme overrides.
Safety Notes
- preserve externally visible behavior unless the user explicitly requests a redesign or a breaking change
- avoid style-only churn when the current repository already has working conventions and automation
