agentsclimarketplace

Hugo expert

Skill ricardodantas/skills/skills/hugo-expert

Expert guidance for building and maintaining Hugo (gohugo.io) static sites — templating and layouts, theme creation and customization, content modeling, configuration and Hugo Modules, performance and the asset pipeline, deployment and CI, multilingual/i18n, SEO and feeds, and version upgrades. Fetches version-appropriate Hugo docs via Context7. Use inside or when starting a Hugo repo — building or customizing a theme, fixing or writing Go templates and partials, configuring hugo.toml or modules, optimizing builds, deploying, adding i18n or SEO, upgrading Hugo, or any "Hugo best practices" question. For writing blog posts in the author's voice, use hugo-write-post.From its SKILL.md

Install
npx -y skills add ricardodantas/skills --skill hugo-expert

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

4.4 KB, as published. Nobody here has run it

Hugo Expert

Deep help with Hugo static sites. This skill carries durable Hugo best-practices and pins live documentation lookups to the repo's actual Hugo version — Hugo ships frequently and APIs change, so verify current syntax against the docs rather than from memory.

Preflight — live docs via find-docs

Current Hugo syntax, template functions, and config keys are fetched with the find-docs skill (Context7). Confirm it's available (it appears in your available skills); if it's missing, tell the user and offer to install it — npx skills find find-docs. Without it, say so and proceed from general knowledge, flagging that version-specific details may be stale.

1. Detect the target version

Run the detector at the repo root to pin doc lookups to the right version:

"<skill-dir>/scripts/detect_hugo.py" .

It reports the config file/format, the pinned Hugo version, Hugo Modules usage, an extended-vs-standard hint, and configured themes. For a brand-new repo (is_new_repo), use the latest Hugo release — look it up (hugo version, the GitHub releases page, or Context7); never assume a hardcoded version.

2. Fetch current docs when it matters

Before asserting exact template-function signatures, config keys, or version-specific behavior, use the find-docs skill to pull the current Hugo docs (library Hugo → /gohugoio/hugo). Query one specific topic at a time, and pin the repo's version when it declares one. Rely on the references below for durable practice; reach for live docs when the detail is version-sensitive.

3. Route to the reference for the task

Read only the file(s) the task needs:

TaskReference
Go templates, partials, blocks, render hooks, lookup orderreferences/templating.md
Creating/customizing a theme, overriding, publishingreferences/themes.md
Sections, page/leaf bundles, taxonomies, front matter, archetypesreferences/content-modeling.md
hugo.toml/environments, Hugo Modules, mountsreferences/config-modules.md
Hugo Pipes, image processing, minify/fingerprint, cachingreferences/performance.md
Netlify/Vercel/Pages, CI, HUGO_VERSION, baseURLreferences/deployment.md
Version bumps, deprecations, extended vs standardreferences/upgrade-migration.md
Multilingual sites, translationsreferences/i18n.md
Sitemap, RSS/output formats, meta/OpenGraph, structured datareferences/seo-feeds.md

4. Best-practice bar (holds across versions)

  • Prefer configuration over hardcoding; keep environment-specific values in config/<env>/.
  • Build themes as Hugo Modules over copying files; override by shadowing layouts in the project.
  • Compose layouts from partials and render hooks; don't duplicate markup across templates.
  • Route CSS/JS/images through the asset pipeline (Hugo Pipes) — fingerprint and minify for production.
  • Pin HUGO_VERSION in CI/deploy so local and production builds match.
  • Verify with hugo server during work and a clean hugo --minify before shipping; treat build warnings and deprecations as work to resolve.

5. Writing blog posts → delegate

To write a blog post in the author's established voice, use the hugo-write-post skill rather than drafting prose here.

6. Validate the work

Confirm the site still builds: hugo completes without errors, hugo server renders the change, and no new deprecation warnings were introduced. Report the outcome and any warnings.

Keep looking

Skills are one crate of 609,856. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.