tui-validate

Name: tui-validate
Availability: InStock
Author: Happyverse-Team

Validate TUI layouts and content using an LLM-based judge.

Updated Jan 29, 2026

Search Tags:#validation #LLM #tmux #terminal #tui #freeze

Ready to run

npx skills add https://github.com/Happyverse-Team/video-content-generator --skill tui-validate-happyverse-team

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tui-validate
Source: https://github.com/Happyverse-Team/video-content-generator/tree/main/.claude/skills/tui-validate
Command: npx skills add https://github.com/Happyverse-Team/video-content-generator --skill tui-validate-happyverse-team

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Terminal User Interfaces (TUIs) are often hard to validate with brittle text checks. This skill enables automated, semantic validation of TUI output by capturing the UI with freeze (and optionally tmux or direct commands) and evaluating it with an LLM-based judge to ensure layout correctness and content presence.

Core Features & Use Cases

Semantic validation of TUI layouts, content presence, and visual hierarchy
Supports file, command, tmux, and buffer targets for flexible testing
Generates both visual captures (SVG/PNG) and textual representations for robust analysis
Useful for regression testing of dashboards, status screens, and editor-like TUIs

Quick Start

Use the tui-validate skill to verify a TUI's header and layout in a sample run. Prepare a test target (a captured file, a live tmux session, or a command) and run the validator with criteria configured to Ralph-style header/footer checks.

Frequently Asked Questions about tui-validate

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

FAQPage Schema

How do I validate TUI layouts without brittle text matching?▼

Semantic validation of TUI layouts uses an LLM-based judge to evaluate captured terminal output, checking visual hierarchy and content presence instead of exact text matching. It verifies header and footer correctness robustly.

Can I capture terminal output from a live tmux session for semantic validation?▼

Yes, semantic validation supports capturing terminal output from live tmux sessions, direct commands, or files. The freeze tool generates visual captures like SVG or PNG alongside textual representations for comprehensive LLM analysis.

What is the best way to automate regression testing for terminal dashboards?▼

Automated regression testing for terminal dashboards captures TUI output using the freeze tool and evaluates it with an LLM judge. It checks visual layouts and content presence, integrating seamlessly with existing test workflows.

Does the freeze tool support generating visual captures for TUI testing?▼

Yes, the freeze tool supports generating visual captures in SVG and PNG formats for TUI testing. These visual outputs complement textual representations to provide robust data for the LLM-based semantic judge.

Why do my terminal UI tests fail when layout shifts slightly?▼

Terminal UI tests fail on slight layout shifts because traditional text matching is brittle. Semantic validation solves this by using an LLM judge to evaluate the visual layout and textual content holistically rather than character by character.