spec-to-hugo

Convert Markdown specifications into Hugo documentation sites with Hextra theme.

Updated May 3, 2026
One-click install
npx skills add https://github.com/ousiass/dotfiles --skill spec-to-hugo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-to-hugo
Source: https://github.com/ousiass/dotfiles/tree/main/.claude/skills/spec-to-hugo
Command: npx skills add https://github.com/ousiass/dotfiles --skill spec-to-hugo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the manual, error-prone work of converting existing Markdown specifications into a structured Hugo documentation site that uses the Hextra theme.

Core Features & Use Cases

  • Hugo site scaffolding for Hextra: Generates Hugo Module configuration, site settings, and required theme/layout integration files so the docs can be published consistently.
  • Automatic content mapping: Copies or links spec Markdown from spec/ or docs/ into content/docs/ with correct folder mapping for flat and hierarchical structures.
  • Frontmatter enrichment and navigation: Adds or adjusts frontmatter (title/weight/description) and creates _index.md section pages to make the sidebar and hierarchy work immediately.

Quick Start

Ask the skill to convert your existing Markdown specifications under spec/ (or docs/) into a ready-to-deploy Hugo Hextra documentation site using the generated Cloudflare Worker and Netlify Edge authentication templates.

Frequently Asked Questions about spec-to-hugo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert existing Markdown specifications into a Hugo documentation site?

Generating a Hugo documentation site from Markdown specifications requires mapping spec or docs directories into content/docs, normalizing frontmatter, and scaffolding Hugo Module configuration for the Hextra theme. This creates a publishable docs structure with sidebar indexes and section hierarchy.

How does the Hextra theme integrate with Hugo for documentation sites?

The Hextra theme integrates with Hugo by using Hugo Module configuration, site settings, and required theme layout integration files. This setup ensures documentation can be published consistently with functional sidebar navigation and section hierarchies.

Do I need Hugo and Go installed to generate a Hextra documentation site?

Yes, you need Hugo and Go availability to generate a Hextra documentation site. The process requires Hugo Module setup and theme integration files, which depend on the Go environment to scaffold and build the documentation structure correctly.

How do I set up Basic Auth routing for Hugo docs on Cloudflare Workers and Netlify Edge Functions?

Setting up Basic Auth routing for Hugo docs involves generating platform-specific authentication templates for Cloudflare Workers and Netlify Edge Functions. These templates provide deploy-ready configuration to secure your documentation site during hosting.

Can I automatically generate sidebar navigation and section indexes from flat Markdown folders?

Yes, you can automatically generate sidebar navigation from flat or hierarchical Markdown folders. The conversion process adds or adjusts frontmatter like title and weight, and creates _index.md section pages to make the sidebar and hierarchy work immediately.

What is the best way to scaffold a deploy-ready Hugo Hextra site from existing docs?

The best way to scaffold a deploy-ready Hugo Hextra site is to automate content copying, frontmatter enrichment, and platform-specific configuration generation. This eliminates manual work by producing Hugo Module setup and Basic Auth routing templates for common hosting targets.