메뉴
Validates the Coop TUI by capturing output from a tmux session using freeze and applying LLM-as-judge semantic validation. Supports text and visual (PNG/SVG) validation modes.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
SOC 직업 분류 기준
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/lightclient/coop --skill tui-validate명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
| name | tui-validate |
| description | Validates the Coop TUI by capturing output from a tmux session using freeze and applying LLM-as-judge semantic validation. Supports text and visual (PNG/SVG) validation modes. |
| type | anthropic-skill |
| version | 1.0 |
This skill validates the Coop TUI by launching it in a tmux session, sending input, capturing the rendered output with freeze, and using LLM-as-judge for semantic validation.
Philosophy: Rather than brittle string matching, this skill uses semantic understanding to validate that TUI output "looks right" — checking layout, content presence, and visual hierarchy without breaking on minor formatting changes.
Required:
freeze CLI tool installed (charmbracelet/freeze)tmux for interactive TUI capturecoop binary built (cargo build --release)freeze --help | head -1
tmux -V
ls target/release/coop
target (required): What to validate. One of:
tmux:<session> — Capture a live tmux session panecommand:<cmd> — Execute a command and capture outputbuffer:<text> — Raw text/ANSI to validate directlycriteria (required): Validation criteria. Can be:
output_format (optional, default: "svg"): Screenshot format
svg — Vector format, good for documentationpng — Raster format, good for visual difftext — Text-only extraction, fastestsave_screenshot (optional, default: false): Save screenshot to working directory
judge_mode (optional, default: "semantic"): Validation approach
semantic — LLM judges based on meaning and layoutstrict — Also checks exact content presencevisual — Requires PNG, checks visual appearancecoop-connectedValidates Coop TUI launched and connected successfully:
coop-responseValidates Coop TUI received an assistant response:
coop-tool-activityValidates tool call activity is visible:
coop-fullComplete Coop TUI layout validation:
tui-basicGeneric TUI validation:
Launch Coop in a tmux session:
# Kill any existing session
tmux kill-session -t coop-test 2>/dev/null || true
# Start a new detached session running coop
tmux new-session -d -s coop-test -x 120 -y 40 'target/release/coop chat'
# Wait for TUI to initialize
sleep 2
Send input to the TUI via tmux:
# Type a message
tmux send-keys -t coop-test "say hello" Enter
# Wait for response (API call + rendering)
sleep 15
Capture TUI output based on target type:
For tmux targets:
# Capture pane text content
tmux capture-pane -t coop-test -p > /tmp/coop-tui-capture.txt
# Generate visual screenshot
tmux capture-pane -t coop-test -p | freeze -o /tmp/coop-tui-capture.svg --theme base16 --width 120
For command targets:
freeze --execute "{command}" -o /tmp/coop-tui-capture.{format} --theme base16
For buffer targets:
echo "{buffer}" | freeze -o /tmp/coop-tui-capture.{format} --theme base16
Constraints:
freeze is installed before attempting capture--theme base16 for consistent rendering--width 120Extract content for LLM analysis:
text, use the captured text directlysvg or png, also capture a text version for content analysisApply LLM-as-judge with the appropriate criteria:
Semantic Validation:
Analyze this terminal UI output and determine if it meets the following criteria:
CRITERIA:
{criteria_description}
TERMINAL OUTPUT:
{captured_text}
Evaluate each criterion and provide:
1. PASS or FAIL for each requirement
2. Brief explanation for any failures
3. Overall verdict: PASS or FAIL
Be lenient on exact formatting/whitespace but strict on:
- Required content presence
- Logical layout and hierarchy
- No rendering errors or artifacts
Visual Validation (with PNG image):
Examine this terminal screenshot and validate:
CRITERIA:
{criteria_description}
Check for:
1. Visual hierarchy and layout
2. Color coding correctness
3. No rendering artifacts or broken characters
4. Proper alignment and spacing
Verdict: PASS or FAIL with explanation
Constraints:
Clean up the tmux session:
# Quit the TUI gracefully
tmux send-keys -t coop-test C-c
sleep 1
# Kill the session
tmux kill-session -t coop-test 2>/dev/null || true
Report validation results:
On PASS:
✅ TUI Validation PASSED
Criteria: {criteria_name}
Target: {target}
Mode: {judge_mode}
All requirements satisfied.
{optional_notes}
On FAIL:
❌ TUI Validation FAILED
Criteria: {criteria_name}
Target: {target}
Mode: {judge_mode}
Issues found:
- {issue_1}
- {issue_2}
Screenshot saved: {path_if_saved}
/tui-validate target:tmux:coop-test criteria:coop-connected
Process:
coop-testtmux capture-pane -t coop-test -p > /tmp/capture.txttmux capture-pane -t coop-test -p | freeze -o /tmp/capture.svg --theme base16 --width 120coop-connected criteria via LLM judge/tui-validate target:tmux:coop-test criteria:coop-response
Process:
coop-response criteria — check for user message and assistant reply/tui-validate target:tmux:coop-test criteria:coop-tool-activity save_screenshot:true
Process:
[calling tool: ...], [executing: ...])/tui-validate target:tmux:coop-test criteria:"Shows the agent name 'reid' in the UI and displays at least one assistant response" judge_mode:strict
/tui-validate target:buffer:"Connected to reid (claude-sonnet-4-20250514). Type a message or /quit to exit." criteria:coop-connected output_format:text
A complete TUI validation session typically looks like:
# 1. Build
cargo build --release
# 2. Launch in tmux
tmux kill-session -t coop-test 2>/dev/null || true
tmux new-session -d -s coop-test -x 120 -y 40 'target/release/coop chat'
sleep 2
# 3. Validate startup
# /tui-validate target:tmux:coop-test criteria:coop-connected
# 4. Send a message
tmux send-keys -t coop-test "say hello" Enter
sleep 15
# 5. Validate response
# /tui-validate target:tmux:coop-test criteria:coop-response save_screenshot:true
# 6. Teardown
tmux send-keys -t coop-test C-c
sleep 1
tmux kill-session -t coop-test 2>/dev/null || true
name: coop-connected
description: Coop TUI launched and connected
requirements:
- name: connection_message
description: Shows "Connected to" system message with agent name
required: true
- name: model_display
description: Shows model name in connection info
required: true
- name: no_errors
description: No "Error:" messages present
required: true
- name: input_area
description: Input/prompt area visible at bottom
required: true
name: coop-response
description: Coop TUI received an assistant response
requirements:
- name: user_message
description: The user's sent message is visible
required: true
- name: assistant_response
description: An assistant response is present with content
required: true
- name: no_errors
description: No "Error:" messages present
required: true
- name: not_loading
description: Loading indicator is not showing (response complete)
required: true
name: coop-tool-activity
description: Tool calling activity visible in TUI
requirements:
- name: tool_indicator
description: Shows tool call indicators like "[calling tool: ...]" or "[executing: ...]"
required: true
- name: assistant_response
description: An assistant response follows tool activity
required: true
- name: no_errors
description: No "Error:" messages present
required: true
# Linux — download binary
curl -sSfL https://github.com/charmbracelet/freeze/releases/download/v0.1.6/freeze_0.1.6_Linux_x86_64.tar.gz \
| tar xz --strip-components=1 -C /usr/local/bin freeze_0.1.6_Linux_x86_64/freeze
tmux list-sessionstmux capture-pane -t coop-test -p manually to checkANTHROPIC_API_KEY is set in the tmux environmentcoop.toml exists in the working directorytmux send-keys -t coop-test "" "" to verify session is alivesemantic mode for layout/presence checking (default, most forgiving)strict mode when specific text must be presentvisual mode with PNG when appearance matters