audit-generated-config-integrity

Validate design-docs config for type correctness, block order, and union coverage.

Updated Aug 23, 2025
One-click install
npx skills add https://github.com/therealityreport/trr-app --skill audit-generated-config-integrity
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-generated-config-integrity
Source: https://github.com/therealityreport/trr-app/tree/main/.agents/skills/design-docs-agent/audit-generated-config-integrity
Command: npx skills add https://github.com/therealityreport/trr-app --skill audit-generated-config-integrity

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post-generation validation gate runs after design-docs generation to ensure the resulting configuration is type-safe, properly ordered, unique, and fully covers all union types.

Core Features & Use Cases

  • TypeScript compilation validation to guarantee the design-docs config builds without errors.
  • ContentBlock order verification to align with source HTML document order (header before byline, etc.).
  • Per-article fonts and colors uniqueness to prevent accidental content duplication across articles.
  • ContentBlock union coverage to ensure every block type has a renderer and is defined in the union.
  • Chart data presence checks for any birdkit or datawrapper blocks, with corresponding constants exported and used in rendering.
  • Required fields validation ensuring url, fonts, and contentBlocks meet minimum criteria.
  • Background color consistency with the brand rendering context.

Quick Start

Run this policy after design-docs generation to validate the generated config before syncing brand pages.

Frequently Asked Questions about audit-generated-config-integrity

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

FAQPage Schema
How do I validate generated design-docs configuration for type correctness before rendering?

Validate design-docs configuration by running a post-generation gate that enforces TypeScript compilation, contentBlock union coverage, and block order alignment. This ensures the config is type-safe, properly ordered, and unique before brand sync.

What is contentBlock union coverage validation in a design-docs pipeline?

ContentBlock union coverage validation ensures every block type defined in the union has a corresponding renderer. This prevents rendering failures by verifying the generated config fully covers all block types before processing.

How do I check contentBlock order against source HTML document order?

Check contentBlock order by verifying the generated config aligns with the source HTML document order, such as ensuring the header appears before the byline. This maintains structural consistency between the source and rendered output.

Why does my design-docs config fail TypeScript compilation after generation?

Design-docs config fails TypeScript compilation when required fields like url, fonts, or contentBlocks are missing or incorrectly typed. A validation gate applies TypeScript compilation checks to catch these errors and provide remediation guidance.

Does design-docs config validation check for chart data presence in datawrapper blocks?

Yes, design-docs config validation checks for chart data presence in any birdkit or datawrapper blocks. It verifies that corresponding constants are exported and used in the rendering pipeline to prevent empty visualizations.

Can I enforce per-article fonts and colors uniqueness across generated design-docs?

Yes, you can enforce per-article fonts and colors uniqueness by running a post-generation validation policy. This prevents accidental content duplication across articles and ensures background color consistency with the brand rendering context.