tui-validate

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

3.1k|286|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill tui-validate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tui-validate
Source: https://github.com/mikeyobrien/ralph-orchestrator/tree/main/.claude/skills/tui-validate
Command: npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill tui-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams ensure terminal UIs render correctly by validating outputs with LLM-based semantics and visual verification.

Core Features & Use Cases

  • Semantic validation of TUI output using LLMs to assess layout and content.
  • Visual verification using freeze for high-fidelity terminal screenshots.
  • Use Case: Validate that a Ralph TUI header and related components render correctly after changes, ensuring iteration counters, time stamps, and mode indicators appear as expected.

Quick Start

Use the tui-validate skill to validate captured terminal output or a live TUI session against predefined criteria.

Frequently Asked Questions about tui-validate

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

FAQPage Schema
How do I validate terminal UI layouts using LLM semantic checks?▼

You can validate terminal UI layouts by capturing terminal output and applying LLM-based semantic checks to assess content presence and structure. This approach evaluates captured files or live tmux sessions against configurable criteria.

Can I use freeze to capture terminal screenshots for visual verification?▼

Yes, freeze is supported as an external tool for high-fidelity visual verification of terminal outputs. It captures screenshots that are then evaluated against defined visual criteria.

Does tui-validate work with live tmux sessions?▼

Yes, tui-validate operates directly on live tmux sessions to evaluate terminal output. It captures the session output and assesses layout and content against predefined validation criteria.

How do I check if specific TUI components like headers and footers render correctly?▼

You can validate specific TUI components by defining configurable header, footer, and full-layout criteria. The semantic judging mode then evaluates the captured output to ensure components render as expected.

What is the difference between semantic and visual judging modes for TUI validation?▼

Semantic judging uses LLMs to assess layout and content presence, while visual judging relies on freeze for high-fidelity terminal screenshots. Both modes evaluate output against your defined criteria.

Do I need external tools installed to validate TUI outputs?▼

Yes, this skill requires external tools such as freeze and tmux to capture and validate terminal outputs. These dependencies are necessary for both visual verification and live session capture.