About hugo-template-dev
A development skill for Hugo templates that sets out checks and references for template changes, product-specific behavior, and new shortcodes. It emphasizes inspecting existing patterns and verifying runtime behavior beyond a successful build.
Key features
- 01Change-specific evidence requirements
- 02Runtime Cypress test guidance
- 03Data-driven product context
- 04Shortcode documentation and tests
Use cases
- 01Modify a Hugo template or partial
- 02Implement product-specific template behavior
- 03Add a shortcode with tests and docs
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ influxdata/ docs-v2 --skill hugo-template-devAfter installing, type/hugo-template-devin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/product-data.mdruntime-testing.mdshortcodes.mdDetails
From the project READMEHugo template development
| Change | Required evidence | Load |
|---|---|---|
| Template or partial | Hugo build plus runtime Cypress coverage | references/runtime-testing.md |
| Product-specific behavior | Data-driven product context, no magic values | references/product-data.md |
| New shortcode | example page, docs, and Cypress behavior test | references/shortcodes.md |
Prerequisites: inspect nearby patterns and the page cascade. Never branch on a
hardcoded product name, version, or URL segment when data/products.yml and
the product context partial provide the fact. A build does not prove runtime
behavior.
npx hugo --quiet
node cypress/support/run-e2e-specs.js <content-file>
Load the route-specific reference only when that condition applies.
Comments
Markdown supported