Agent skill

Hugo Template Guidance

by gethugothemes in gethugothemes/parsa-hugo

A skill your agent uses whenever you need to understand how this theme works — adding pages, managing content, configuring the site, using partials/components/modules, project architecture, scripts…

MITAuto-check passedFrontend & Design

Install Hugo Template Guidance

skills CLI
$ npx skills add gethugothemes/parsa-hugo --skill hugo-template-guidance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install gethugothemes/parsa-hugo hugo-template-guidance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/gethugothemes/parsa-hugo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/hugo-template-guidance .claude/skills/hugo-template-guidance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hugo-template-guidance
GitHub stars
162
Token cost
~699 tokens
SKILL.md length
210 words
Files
12 (incl. references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses whenever you need to understand how this theme works — adding pages, managing content, configuring the site, using partials/components/modules, project architecture, scripts…

  • Works in 2 steps: Read the matching reference. → Follow it.
  • You need to understand how this theme works — adding pages
  • SKILL.md covers Routing Guide and Steps
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hugo Template Guidance is an agent skill from gethugothemes/parsa-hugo. 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.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including reference files (for example `references/adding-new-pages.md`, `references/component-usage.md` and `references/content-management.md`).

It sits in Frontend & Design, covering Static sites and blogs. It works with Tailwind CSS. The repository describes itself as: Parsa is a personal blog theme powered by Hugo. It also can be used for portfolio website. The licence is MIT.

When your agent uses it

  • You need to understand how this theme works — adding pages
  • Managing content
  • Configuring the site
  • Using partials/components/modules

Example prompts

  • “/hugo-template-guidance”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Read the matching reference.
  2. Follow it.

What it can do on your machine

Read from SKILL.md and the folder at commit 2452f49. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hugo Template Guidance loads about 699 tokens when it runs, and up to ~9.2k if it reads all its reference files. Until then it costs about 92 tokens; SKILL.md has 210 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~699
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from gethugothemes/parsa-hugo at commit 2452f49, republished under its MIT licence (© gethugothemes). 210 words, ~699 tokens.

Download SKILL.mdSave it as .claude/skills/hugo-template-guidance/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
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.

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

RequestRead
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 flowreferences/project-architecture.md
Add a page, route, or homepage sectionreferences/adding-new-pages.md
Partials, components, shortcodes, Hugo Modulesreferences/component-usage.md
Add, remove, or enable a Hugo Module (module.toml)references/hugo-modules.md
Markdown content, frontmatter, taxonomiesreferences/content-management.md
Add/configure a new language, multilingual, i18n, translatereferences/i18n-guidance.md
Site config, menus, social, feature toggles, SEOreferences/page-configuration.md
Package manager detection, scripts, generators, module updatesreferences/script-usage.md
Styling/theming (Tailwind v4, Bootstrap 5, or hybrid — verify first), dark mode, design tokensreferences/styling-and-theming.md

Steps

  1. Read the matching reference.
  2. Follow it.

© gethugothemes, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (references) in .agents/skills/hugo-template-guidance of gethugothemes/parsa-hugo.

  • SKILL.md
  • references/adding-new-pages.md
  • references/component-usage.md
  • references/content-management.md
  • references/detect-mode.md
  • references/hugo-modules.md
  • references/i18n-guidance.md
  • references/page-configuration.md
  • references/preflight-checks.md
  • references/project-architecture.md
  • references/script-usage.md
  • references/styling-and-theming.md

Open the folder on GitHubat commit 2452f49

Used in 4 other repositories

We found 4 copies of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in gethugothemes/parsa-hugo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Hugo Template Guidance next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hugo Template Guidance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hugo Template Guidance this skillgethugothemes/parsa-hugo162—~699Automated safety check: PassMIT
Kill AI Slopyetone/kill-ai-slop1.3k—~1.4kAutomated safety check: PassApache-2.0
Static Sitesbionic-gpt/bionic-gpt2.4k—~920Automated safety check: PassApache-2.0
Nuxt UImegaarmos/vue-spring-bottom-sheet1411 repos~2.5kAutomated safety check: PassMIT
UI Upstream Syncfulldotdev/ui611—~1.3kAutomated safety check: PassMIT
GlideSrivarsanK/Glide120—~1.7kAutomated safety check: PassApache-2.0

Similar skills

  • Kill AI Slop

    yetone/kill-ai-slop

    Find and remove AI slop — the generic, machine-default visual and copy tics of vibe-coded products — from a web project.

    1.3k GitHub stars~1.4k tokensUpdated 26 days ago
    Frontend & DesignAuto-check passed
  • Static Sites

    bionic-gpt/bionic-gpt

    Create or modify Bionic's generated marketing site, documentation, blog, course pages, and static assets.

    2.4k GitHub stars~920 tokensUpdated 4 days ago
    Frontend & DesignAuto-check passed
  • Nuxt UI

    megaarmos/vue-spring-bottom-sheet

    Build UIs with @nuxt/ui v4 — 125+ accessible Vue components with Tailwind CSS theming.

    141 GitHub starsUsed in 1 repo~2.5k tokens
    Frontend & DesignAuto-check passed
  • UI Upstream Sync

    fulldotdev/ui

    Audit and update the existing Fulldev Astro UI registry against current data-slot and shadcn/ui Base UI Vega.

    611 GitHub stars~1.3k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Glide

    SrivarsanK/Glide

    Authoritative guide and toolset for AI agents to operate, configure, and visually design applications using Glide (@srivarsank/glide).

    120 GitHub stars~1.7k tokensUpdated 10 days ago
    Frontend & DesignAuto-check passed
  • Bryl Minimal Design

    bryllim/bryl-minimal-design

    Apply the bryl-minimal design language — a monochrome, typography-driven minimal aesthetic with halftone dot textures, pixel-font display headings, tiny uppercase monospace labels, soft large-radius…

    115 GitHub stars~2.9k tokensUpdated 3 mo ago
    Frontend & DesignAuto-check passed

Works with

Questions about Hugo Template Guidance

What does Hugo Template Guidance do?

A skill your agent uses whenever you need to understand how this theme works — adding pages, managing content, configuring the site, using partials/components/modules, project architecture, scripts…. Hugo Template Guidance is an agent skill from gethugothemes/parsa-hugo. 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).

When should I use Hugo Template Guidance?

Hugo Template Guidance fits situations like: you need to understand how this theme works — adding pages; managing content; configuring the site; using partials/components/modules.

How do I install Hugo Template Guidance in Claude Code?

Run `npx skills add gethugothemes/parsa-hugo --skill hugo-template-guidance -a claude-code`. Or copy the skill folder (.agents/skills/hugo-template-guidance in gethugothemes/parsa-hugo) into .claude/skills/hugo-template-guidance in your project. Claude Code loads it when a task matches its description.

How do I install Hugo Template Guidance in Codex?

Run `npx skills add gethugothemes/parsa-hugo --skill hugo-template-guidance -a codex`. Or copy the skill folder (.agents/skills/hugo-template-guidance in gethugothemes/parsa-hugo) into .agents/skills/hugo-template-guidance in your project. Codex loads it when a task matches its description.

Can I use Hugo Template Guidance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add gethugothemes/parsa-hugo --skill hugo-template-guidance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hugo-template-guidance, .gemini/skills/hugo-template-guidance, .github/skills/hugo-template-guidance and .opencode/skills/hugo-template-guidance in your project.

What does Hugo Template Guidance need to run?

SKILL.md names no scripts, command-line tools or credentials: Hugo Template Guidance is instructions for the agent only.

Does Hugo Template Guidance access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hugo Template Guidance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hugo Template Guidance use?

Hugo Template Guidance is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hugo Template Guidance use?

About 699 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.5k tokens, read only when the agent opens those files.

What are the alternatives to Hugo Template Guidance?

Skills that share tags, products or a category with Hugo Template Guidance: Kill AI Slop (yetone/kill-ai-slop, 1.3k stars), Static Sites (bionic-gpt/bionic-gpt, 2.4k stars), Nuxt UI (megaarmos/vue-spring-bottom-sheet, 141 stars) and UI Upstream Sync (fulldotdev/ui, 611 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hugo Template Guidance?

gethugothemes (a GitHub organization) maintains it in gethugothemes/parsa-hugo, which has 162 GitHub stars. The repository was last updated on July 12, 2026.

Source: gethugothemes/parsa-hugo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.