skills.rest
Happyverse-Team
Happyverse-TeamOFFICIAL
Explore all skills by this author →
GitHub

tui-validate

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

Updated Jan 29, 2026
Search Tags:#validation#LLM#tmux#terminal#tui#freeze
One-click install
npx skills add https://github.com/Happyverse-Team/video-content-generator --skill tui-validate-happyverse-team
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
mikeyobrienmikeyobrien
3.1k

tui-validate

Validate TUI outputs from files, commands, or tmux sessions using semantic and visual checks.

Community
Advanced
vasilyu1983vasilyu1983
73

ai-mlops

Automate production ML lifecycle with drift monitoring and automated retraining.

Community
Advanced
tilework-techtilework-tech
166

TUI Puppeteering with tmux

Automate isolated TUI testing workflows using tmux-based scripts.

Official
Advanced
shinnytechshinnytech

Remembering Conversations

Index and search historical Claude Code conversations with semantic and exact text matching.

Official
Advanced