validate-all

Validate Hugo and Obsidian site content for frontmatter, links, orphans, drafts, and lengths.

3|Updated Dec 30, 2025

Search Tags:#qa #content #links #validate #drafts #orphan-content #length-analysis

Ready to run

npx skills add https://github.com/unfinishablemap/unfinishablemap --skill validate-all

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: validate-all
Source: https://github.com/unfinishablemap/unfinishablemap/tree/main/.claude/skills/validate-all
Command: npx skills add https://github.com/unfinishablemap/unfinishablemap --skill validate-all

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates the health and integrity of The Unfinishable Map site content, catching issues before deployment and reducing manual QA overhead.

Core Features & Use Cases

Frontmatter integrity: Verifies required fields and consistency across Hugo and Obsidian content.
Link and orphan detection: Finds broken internal links and content with no inbound references for human review.
Draft monitoring & length analysis: Flags stale drafts and analyzes article lengths to meet section targets.
Automated logging: Appends a changelog entry with validation results to obsidian/workflow/changelog.md for traceability.

Quick Start

Use the validate-all skill to perform a full site health check. Run: uv run python scripts/validate.py hugo/content/ --strict If you want to also check links during active dev, invoke the check-links path and review the changelog at obsidian/workflow/changelog.md.

Frequently Asked Questions about validate-all

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

FAQPage Schema

How do I validate Hugo content and check for broken links before deployment?▼

You can validate Hugo content and check for broken links by running a Python script through uv that scans hugo/content and obsidian sources to detect frontmatter issues, invalid links, and orphaned content without altering files.

What is orphan content detection and how does it work for static sites?▼

Orphan content detection identifies pages or notes with no inbound references. This validation process scans your Hugo and Obsidian sources to flag content that no internal links point to, helping you review unused articles before deployment.

How do I check frontmatter integrity across Hugo and Obsidian sources?▼

You check frontmatter integrity across Hugo and Obsidian sources by running a validation script that verifies required fields and consistency across all content files, ensuring your metadata meets structural requirements before deployment.

Can I monitor stale drafts and analyze article length in Hugo content?▼

Yes, you can monitor stale drafts and analyze article length in Hugo content by running a full site health check script that flags drafts and evaluates article lengths against section targets to maintain content quality.

Does the validation script modify my content files during the health check?▼

The validation script does not modify your content files during the health check. It performs read-only operations on hugo/content and obsidian sources, appending validation results to a separate obsidian workflow changelog for traceability.