design-docs-agent

Coordinate article HTML ingestion into validated design-docs ARTIFACTS pipelines.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Design Docs Agent coordinates the full pipeline to transform raw article HTML into structured, machine-readable design data and production-ready code artifacts.

Core Features & Use Cases

  • Orchestrates parallel extraction waves (CSS tokens, page structure, charts, icons, navigation) and merges outputs into a single ARTICLES config.
  • Generates TypeScript constants, validates type-safety, and wires brand pages and tabs.
  • Supports pre-flight audits and delta reporting for brand syncs.

Quick Start

Provide the article URL and optional local HTML path to initiate the full pipeline.

Frequently Asked Questions about design-docs-agent

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

FAQPage Schema
How do I automate extraction of design tokens and page structure from article HTML?

Automating design token extraction from article HTML involves orchestrating parallel waves for CSS tokens, page structure, charts, and icons. The process merges these outputs into a single machine-readable config with strict frontmatter metadata and type-safety validation.

What is the best way to generate TypeScript constants from raw HTML design data?

Generating TypeScript constants from raw HTML requires ingesting the article content, extracting structural and styling data in parallel waves, and validating the merged output for type-safety. This ensures brand-wide consistency across generated production-ready code artifacts.

How do I validate frontmatter metadata for machine-readable design docs?

Validating frontmatter metadata for machine-readable design docs requires strict type-safety checks during the ingestion pipeline. The system enforces frontmatter-driven metadata rules while merging parallel extraction outputs into a unified ARTICLES config entry.

Can I orchestrate parallel extraction waves for charts and icons from local HTML files?

Yes, you can orchestrate parallel extraction waves for charts and icons by providing an optional local HTML path alongside the article URL. The pipeline coordinates extraction, merges results, and triggers generation and verification steps automatically.

Does this design docs pipeline support pre-flight audits and delta reporting for brand syncs?

The design docs pipeline supports pre-flight audits and delta reporting for brand syncs directly within its orchestration workflow. It ensures brand-wide consistency across 15 tabs by validating type-safety and wiring brand pages during the generation phase.

Why does my HTML to TypeScript design doc pipeline fail type-safety validation?

HTML to TypeScript design doc pipelines fail type-safety validation when frontmatter metadata is missing or inconsistent. The orchestration process enforces strict frontmatter-driven metadata rules and validates generated TypeScript constants before merging them into the final config.