Name: hugo-template-guidance
Author: xai-ed

Imported from xai-ed/xai-ed.github.io (.agents/skills/hugo-template-guidance/SKILL.md). Install upstream with npx skills add xai-ed/xai-ed.github.io --skill hugo-template-guidance. Copyright stays with the author.

Template Guidance

Handbook for this theme (Hugo Extended + Hugo Modules; styling is Tailwind v4, Bootstrap 5, or a hybrid — verify before assuming), assuming the standard project-setup layout (site at root, theme vendored in themes/<theme>/ — the single folder under themes/; see references/detect-mode.md to find its name). Progressive disclosure: read the matching references/ file before acting.

If exampleSite/hugo.toml exists, the repo is still in theme-setup — run <pm> project-setup first (see references/detect-mode.md) before using anything below.

Package manager: <pm> is a placeholder for this project's package manager. Detect it from a lock file (pnpm-lock.yaml, package-lock.json, yarn.lock, bun.lock/bun.lockb) or package.json's packageManager field before running any command below — don't assume pnpm. Details: references/script-usage.md.

Routing Guide

Request	Read
Detect or convert setup mode (theme-setup vs project-setup)	`references/detect-mode.md`
pre-flight checks (Node, Hugo version, package manager)	`references/preflight-checks.md`
Architecture, folder layout, data flow	`references/project-architecture.md`
Add a page, route, or homepage section	`references/adding-new-pages.md`
Partials, components, shortcodes, Hugo Modules	`references/component-usage.md`
Add, remove, or enable a Hugo Module (`module.toml`)	`references/hugo-modules.md`
Markdown content, frontmatter, taxonomies	`references/content-management.md`
Add/configure a new language, multilingual, i18n, translate	`references/i18n-guidance.md`
Site config, menus, social, feature toggles, SEO	`references/page-configuration.md`
Package manager detection, scripts, generators, module updates	`references/script-usage.md`
Styling/theming (Tailwind v4, Bootstrap 5, or hybrid — verify first), dark mode, design tokens	`references/styling-and-theming.md`

Steps

Read the matching reference.
Follow it.

Install hugo-template-guidance and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "xai-ed-xai-ed-github-io-hugo-template-guidance", "kind": "skill", "name": "hugo-template-guidance", "description": "Use whenever you need to understand how this theme works — adding pages, managing content, configuring the site, using partials/components/modules, project architecture, scripts, or styling/theming (Tailwind v4, Bootstrap 5, or a hybrid — verify which). Use for ANY question about the structure, usage, or customization of the template or theme.", "publisher": "xai-ed", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Use whenever you need to understand how this theme works — adding pages, managing content, configuring the site, using partials/components/modules, project architecture, scripts, or styling/theming (Tailwind v4, Bootstrap 5, or a hybrid — verify which). Use for ANY question about the structure, usage, or customization of the template or theme." ], "primary": false, "metadata": { "source": { "provider": "github", "repository": "https://github.com/xai-ed/xai-ed.github.io", "path": ".agents/skills/hugo-template-guidance/SKILL.md", "ref": "55fb8f3c03a60505983755ac290576fbb474bdcb", "url": "https://github.com/xai-ed/xai-ed.github.io/blob/55fb8f3c03a60505983755ac290576fbb474bdcb/.agents/skills/hugo-template-guidance/SKILL.md", "key": "xai-ed/xai-ed.github.io/.agents/skills/hugo-template-guidance/SKILL.md" } }, "instructions": "# Template Guidance\n\nHandbook for this theme (Hugo Extended + Hugo Modules; styling is Tailwind v4, Bootstrap 5, or a hybrid — verify before assuming), assuming the standard **project-setup** layout (site at root, theme vendored in `themes/<theme>/` — the single folder under `themes/`; see `references/detect-mode.md` to find its name). Progressive disclosure: **read the matching `references/` file before acting.**\n\n> If `exampleSite/hugo.toml` exists, the repo is still in theme-setup — run `<pm> project-setup` first (see `references/detect-mode.md`) before using anything below.\n>\n> **Package m", "cost": { "context_tokens": 599 } }

hugo-template-guidance

About

Template Guidance

Routing Guide

Steps

Install hugo-template-guidance and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews