gaia-document-rulesets

Validate Gaia planning documents with two-pass frontmatter and structural checks.

2|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-document-rulesets
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gaia-document-rulesets
Source: https://github.com/gaiastudio-ai/gaia-public/tree/main/plugins/gaia/skills/gaia-document-rulesets
Command: npx skills add https://github.com/gaiastudio-ai/gaia-public --skill gaia-document-rulesets

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gaia artifact validation requires consistent frontmatter and structure; this ruleset provides a centralized, machine-readable contract that guides validators to enforce type-specific checks.

Core Features & Use Cases

  • Two-pass validation with frontmatter/type-detection and structural checks, enabling deterministic document quality gates.
  • Section completeness, mandatory sections, and cross-reference validation across PRD, Infra PRD, Platform PRD, Architecture, UX, Epics, and Gap Analysis artifacts.
  • JIT-loading behavior: the validator subagent loads the applicable rules at runtime to verify artifacts.

Quick Start

Integrate this ruleset with the Gaia validator to apply type-specific document validation across planning artifacts.

Frequently Asked Questions about gaia-document-rulesets

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

FAQPage Schema
How do I validate frontmatter and section structure in Gaia PRD documents?

To validate frontmatter and section structure in Gaia PRD documents, apply a two-pass validation ruleset that checks frontmatter presence, section completeness, section IDs, and cross-reference consistency across artifacts.

What is two-pass validation for artifact quality gates?

Two-pass validation for artifact quality gates is a mechanism that first detects document type and frontmatter, then performs structural checks to ensure deterministic document quality and consistent artifact structure.

Does the Gaia document ruleset support Infra PRD and Architecture artifact checks?

Yes, the Gaia document ruleset supports Infra PRD and Architecture artifact checks, applying type-detection rules and section completeness validation across PRD, Platform PRD, UX, Epics, and Gap Analysis documents.

How do I enforce mandatory sections and cross-reference consistency in planning artifacts?

You can enforce mandatory sections and cross-reference consistency by integrating a centralized ruleset that provides machine-readable contracts for validators to apply structural checks during runtime.

Can I load validation rules at runtime for gap-analysis documents?

Yes, you can load validation rules at runtime for gap-analysis documents using JIT-loading behavior, where the validator subagent dynamically loads applicable rules to verify artifacts on demand.

What are the limitations of using centralized rulesets for document validation?

A limitation of centralized rulesets for document validation is that they require integration with a Gaia validator subagent to function, as they provide machine-readable contracts rather than standalone validation execution.