hugo-content-checker

Audit Hugo content directories for broken links, frontmatter gaps, and duplicates.

2|3|Updated Mar 13, 2021
One-click install
npx skills add https://github.com/RogueRope/docs --skill hugo-content-checker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hugo-content-checker
Source: https://github.com/RogueRope/docs/tree/main/.claude/skills/hugo-content-checker
Command: npx skills add https://github.com/RogueRope/docs --skill hugo-content-checker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automatically identifies and reports common Hugo content issues like broken links, inconsistent frontmatter, orphaned pages, naming violations, and duplicate content, saving manual auditing time and improving overall site quality and user experience.

Core Features & Use Cases

  • Broken Link Detection: Finds and flags internal links pointing to non-existent pages, preventing navigation errors.
  • Frontmatter Validation: Ensures all content files have required metadata fields, crucial for site functionality and search.
  • Duplicate Content Detection: Identifies highly similar pages for consolidation or review, improving content efficiency.
  • Use Case: Before deploying a major update to your Hugo documentation site, run this skill to automatically catch all broken links and ensure every new page has a title and description, preventing a poor user experience.

Quick Start

Use the hugo-content-checker skill to analyze the content in the 'docs/content' directory for broken links and frontmatter issues.

Frequently Asked Questions about hugo-content-checker

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

FAQPage Schema
How do I find broken links in my Hugo documentation site?

Broken link detection identifies internal links pointing to non-existent pages in your Hugo content. Run the hugo-content-checker skill on your content/ directory to automatically flag all broken references, preventing navigation errors before deployment.

Can I validate frontmatter fields across all my Hugo pages automatically?

Frontmatter validation ensures all content files contain required metadata fields like title and description. The skill scans your entire content/ directory and reports missing fields, which is crucial for site functionality, search indexing, and consistency.

What's the best way to detect duplicate content in Hugo?

Duplicate content detection identifies highly similar pages across sections using a scoring threshold of 80% or higher. This helps consolidate redundant content, improve site efficiency, and prevent search ranking penalties from duplicate material.

Does this work with Hugo page bundles and shortcodes?

Yes, the skill analyzes Hugo page bundles, Markdown files, and both ref/relref shortcodes. It audits content structure and link integrity across all these Hugo-native components in a single scan.

How do I catch orphaned pages and naming violations in Hugo?

Orphan detection identifies pages not linked from any other content, while naming validation flags files that violate your site's conventions. The skill reports both issues via structured JSON and human-readable output for easy remediation.