skills.rest
ai-pivot
ai-pivotOFFICIAL
Explore all skills by this author →
GitHub

TUI Debug Skill — Scenario-Driven TUI Simulator

Simulate scenario-driven TUI event flows to validate agent interface behavior.

12|5|Updated Apr 26, 2026
Search Tags:#debugging#simulation#regression testing#scenario#go test#tui#assertions
One-click install
npx skills add https://github.com/ai-pivot/xbot --skill tui-debug-skill-scenario-driven-tui-simulator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: TUI Debug Skill — Scenario-Driven TUI Simulator
Source: https://github.com/ai-pivot/xbot/tree/main/.xbot.example/skills/tui-debug
Command: npx skills add https://github.com/ai-pivot/xbot --skill tui-debug-skill-scenario-driven-tui-simulator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill solves the problem of reliably testing and debugging a TUI agent interface without manually driving the UI every time.

Core Features & Use Cases

  • Scenario-driven TUI simulation: Run scripted sequences of 35+ action types and validate outcomes with 16+ assertion types (messages, views, state, tool timing).
  • Multiple run modes: Generate Markdown output by default, optionally produce JSON output and trace logs for diagnosing step-by-step issues.
  • Regression testing support: Re-run scenario fixtures in bulk to prevent UI/behavior regressions.

Quick Start

Run a scenario by piping your JSON steps into the simulator runner script, for example: echo a valid scene JSON into run-sim.sh with '-' as input so the skill executes the scenario and prints the results.

Frequently Asked Questions about TUI Debug Skill — Scenario-Driven TUI Simulator

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

FAQPage Schema
How do I automate TUI regression testing without manually driving the interface?▼

TUI regression testing is automated by injecting scenario JSON into the simulator test binary to execute scripted action and assertion sequences, validating visual and behavioral outcomes without manual UI interaction.

What is scenario-driven TUI simulation and how does it work?▼

Scenario-driven TUI simulation executes scripted event flows of over 35 action types against an agent interface, validating outcomes using 16+ assertion types for messages, views, state, and tool timing.

How do I run a TUI simulation scenario using the simulator runner script?▼

Run a TUI simulation scenario by piping valid scenario JSON into the runner script with '-' as input, executing TestSimMain with the scenario injected via the XBOT_SIM_SCENARIO environment variable.

Does TUI simulation support trace logging and JSON output for debugging?▼

TUI simulation supports trace logging and JSON output for debugging, controlled by environment variables alongside quiet mode and default Markdown output to diagnose step-by-step issues.

Can I use Go test to run bulk TUI scenario fixtures for regression testing?▼

You can use Go test to run bulk TUI scenario fixtures for regression testing by compiling the simulator test binary and re-running scenario fixtures in bulk to prevent UI and behavior regressions.

What assertions are available for validating TUI state transitions and tool timing?▼

Assertions for validating TUI state transitions include 16+ assertion types covering messages, views, state transitions, and tool timing, enabling precise validation of scripted action outcomes.

Related Skills

Explore More Software Engineering Skills→
lachlanchenlachlanchen
1

goplaces

Query Google Places API for text search, details, and reviews via CLI.

Community
Intermediate
attentiondotnetattentiondotnet

systematic-debugging

Diagnose bugs through four-phase root-cause investigation with evidence gathering and regression verification.

Community
Advanced
nateanatea

regression-testing

Automate regression test selection by change and risk in CI pipelines.

Community
Advanced
s0613s0613
1

s-skills

Orchestrate documentation and test workflow steps based on project metrics.

Community
Advanced