docs-stage-conformance

Audit hy-home.k8s documentation against stage templates and governance rules.

1|Updated Nov 27, 2025

Search Tags:#templates #documentation #validation #docs #drift #conformance

Ready to run

npx skills add https://github.com/buenhyden/hy-home.k8s --skill docs-stage-conformance

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: docs-stage-conformance
Source: https://github.com/buenhyden/hy-home.k8s/tree/main/.agents/skills/docs-stage-conformance
Command: npx skills add https://github.com/buenhyden/hy-home.k8s --skill docs-stage-conformance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps hy-home.k8s documentation aligned with the repository's stage templates and governance rules, reducing drift in documentation indexes and validation artifacts.

Core Features & Use Cases

Audit docs against stage templates (docs/99.templates) and governance rules.
Fix template drift, missing Related Documents links, duplicate H1s, and target-relative link issues.
Collect and preserve validation evidence to support documentation governance.

Quick Start

Perform a targeted conformance pass on docs/99.templates to identify and fix drift.

Frequently Asked Questions about docs-stage-conformance

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

FAQPage Schema

How do I detect documentation drift in repository templates?▼

Documentation drift is detected by auditing docs against stage templates and governance rules to identify missing Related Documents links, duplicate H1s, and target-relative link issues. Conformance checks compare existing docs to templates for structural alignment.

What is template conformance for markdown documentation?▼

Template conformance for markdown documentation ensures files align with predefined stage templates and governance rules. It involves auditing README indexes and template directories to enforce structural consistency, proper heading hierarchy, and required link presence.

How do I fix duplicate H1 headings in markdown files?▼

Duplicate H1 headings are fixed by performing a targeted conformance pass on the affected documentation. The process identifies redundant top-level headings and repairs them to ensure only one H1 exists per file, aligning with template governance rules.

Best way to collect validation evidence for repo governance artifacts?▼

Validation evidence is collected and preserved during targeted conformance passes by logging identified template drift, applied repairs, and structural fixes. This evidence supports documentation governance and tracks progress in repository artifacts.

Does template conformance work without external dependencies?▼

Yes, template conformance checks run without external dependencies. The validation logic operates directly on repository documentation assets, templates, and indexes to detect drift and enforce governance rules natively.

Why are my README indexes missing Related Documents links?▼

README indexes miss Related Documents links when documentation drifts from stage templates. Running a conformance audit identifies missing links and applies targeted repairs to restore proper template alignment and navigation structure.