Agent skill

Tui Render Debug

by dimetron in dimetron/pi-go

Diagnose and fix pi-go TUI rendering corruption, especially displaced panels, stale rows, cursor drift, and terminal-specific ANSI incompatibilities.

MITAuto-check passed

Install Tui Render Debug

skills CLI
$ npx skills add dimetron/pi-go --skill tui-render-debug -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dimetron/pi-go tui-render-debug --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dimetron/pi-go.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.pi-go/skills/tui-render-debug .claude/skills/tui-render-debug && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
tui-render-debug
GitHub stars
207
Token cost
~783 tokens
SKILL.md length
414 words
Files
1
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Diagnose and fix pi-go TUI rendering corruption, especially displaced panels, stale rows, cursor drift, and terminal-specific ANSI incompatibilities.

  • SKILL.md covers Establish the symptom, Separate output leaks from…, Build a red-capable repro and Fix decisions, plus 1 more section
  • Calls rg

What it does

Tui Render Debug is an agent skill from dimetron/pi-go. Diagnose and fix pi-go TUI rendering corruption, especially displaced panels, stale rows, cursor drift, and terminal-specific ANSI incompatibilities.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Go implementation of AI coding agent. The licence is MIT.

Example prompts

  • “/tui-render-debug”

What it can do on your machine

Read from SKILL.md and the folder at commit 24d1f2b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tui Render Debug loads about 783 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 414 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~783

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dimetron/pi-go at commit 24d1f2b, republished under its MIT licence (© dimetron). 414 words, ~783 tokens.

Download SKILL.mdSave it as .claude/skills/tui-render-debug/SKILL.md (or your agent's skills folder).
name
tui-render-debug
description
Diagnose and fix pi-go TUI rendering corruption, especially displaced panels, stale rows, cursor drift, and terminal-specific ANSI incompatibilities.

TUI Render Debugging

Use this skill when pi-go's Bubble Tea interface is broken in a terminal: text appears in the wrong row or column, the sidebar moves, old frames remain after a resize, or a redraw repairs the display.

Establish the symptom

Capture the exact terminal, TERM, COLORTERM, TERMINAL_EMULATOR, terminal size, and whether a full redraw or switching terminal modes repairs the frame. Compare the broken frame with the next clean frame. A clean redraw after a bad incremental frame points to renderer cursor state, not necessarily to bad View() geometry.

For JetBrains IDE terminals, record TERMINAL_EMULATOR=JetBrains-JediTerm. JediTerm can report TERM=xterm-256color while mishandling cursor-backward-tab (CSI Z, CBT), which makes Bubble Tea's differential renderer believe the cursor is in a different column than the emulator.

Separate output leaks from renderer drift

The interactive TUI owns the terminal. Search the active path for direct output:

bash
rg -n 'fmt\.Print|log\.Print|os\.(Stdout|Stderr)|slog\.' internal cmd

Routine diagnostics must use the session logger. User-facing notices must use the TUI message or notice channel. A subprocess's stdout and stderr must be captured and surfaced as a tool result. Direct writes can move the cursor, but the absence of leaked stderr does not rule out a renderer incompatibility.

Build a red-capable repro

Use a PTY with the affected environment and capture stdout and stderr separately. Count and inspect control sequences in stdout; stderr should contain only diagnostics expected outside the frame.

For renderer-level tests, create an ultraviolet.TerminalRenderer with the affected environment, move from a later column to an earlier column, and assert that unsupported CBT is not emitted. Replay the captured bytes through a JediTerm-compatible emulator when available. Also verify ordinary xterm and tmux/screen environments remain unchanged.

Show full SKILL.md (142 more words)Show less

Fix decisions

Keep frame geometry tests independent: every rendered row must match the terminal width, the rail must stay in one display column, and no ANSI escape may leak into visible content. Do not solve a terminal capability bug by changing layout constants.

When the Bubble Tea dependency has no per-capability switch, isolate a compatibility environment to Bubble Tea's renderer. Preserve the original environment for subprocesses and use the original environment for color-profile detection. Prefer disabling only the broken capability when the dependency supports it; otherwise use the narrowest compatible renderer profile and add a comment explaining why.

Verification

Run the focused regression test first, then the full TUI package, race tests for the affected seam, golangci-lint run ./internal/tui/..., and a build. Re-run the PTY capture and confirm the affected terminal no longer drifts while normal terminal output and colors remain intact.

© dimetron, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .pi-go/skills/tui-render-debug of dimetron/pi-go.

Open the folder on GitHubat commit 24d1f2b

Compare with similar skills

Tui Render Debug next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Tui Render Debug compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tui Render Debug this skilldimetron/pi-go207—~783Automated safety check: PassMIT
Debugasgeirtj/system_prompts_leaks69k—~439Automated safety check: PassCC0-1.0
Debug Tuitrasta298/keifu811—~1.3kAutomated safety check: PassMIT
Tui Debug In Panemikeyobrien/ralph-orchestrator3.2k—~825Automated safety check: PassMIT
Openclaw Debuggingopenclaw/openclaw392k—~1.9kAutomated safety check: PassMIT
Debugging Executionsn8n-io/n8n207k—~2.6kAutomated safety check: PassCustom licence

Similar skills

  • Debug

    asgeirtj/system_prompts_leaks

    Enable debug logging for this session and help diagnose issues

    69k GitHub stars~439 tokensUpdated today
    Auto-check passed
  • Debug Tui

    trasta298/keifu

    Drive and debug the real keifu TUI autonomously via its remote-control debug server (--debug-listen) — launch headlessly, inject keys/mouse, dump the rendered screen as text, and inspect app state.

    811 GitHub stars~1.3k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Tui Debug In Pane

    mikeyobrien/ralph-orchestrator

    A skill your agent uses when you need to reproduce or debug TUI rendering issues (garbled output, broken streaming, layout corruption) by running ralph in a tmux split pane and capturing live output.

    3.2k GitHub stars~825 tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Openclaw Debugging

    openclaw/openclaw

    Debug OpenClaw model, provider, tool-surface, code-mode, streaming, and live/Crabbox behavior by choosing the right logs, probes, and proof path before changing code, including fetching stored…

    392k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Official

    Debug failed or wrong-output workflow executions using executions tools.

    207k GitHub stars~2.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Debugging Toolkit

    sickn33/agentic-awesome-skills

    A skill your agent uses when working with debugging toolkit smart debug (Alias for debugging-toolkit-smart-debug)

    47k GitHub starsUsed in 1 repo~344 tokens
    DevelopmentAuto-check passed

More from dimetron/pi-go

All 21 skills in this repo
  • Vhs E2E Gif

    dimetron/pi-go

    Record a test run, a TUI session, or any terminal command as a GIF with VHS and attach it to a GitHub PR as a release-hosted asset, never a repo commit.

    207 GitHub stars~1.7k tokensUpdated 7 days ago
    Auto-check passed
  • Agents Md

    dimetron/pi-go

    Generate AGENTS.md files for Go, Rust, TypeScript, and Java projects.

    207 GitHub stars~1.7k tokensUpdated 7 days ago
    Auto-check passed
  • Bubbletea Testing

    dimetron/pi-go

    A skill your agent uses whenever writing tests for Bubble Tea (charmbracelet/bubbletea) TUI applications in Go.

    207 GitHub stars~3.6k tokensUpdated 7 days ago
    Auto-check passed
  • Memory Index

    dimetron/pi-go

    Index a folder's contents into the MemPalace semantic memory for search and retrieval.

    207 GitHub stars~1.5k tokensUpdated 7 days ago
    Auto-check passed
  • Nightly Session Watch

    dimetron/pi-go

    Nightly sweep of the last 24h of pi-go sessions — anomalous runs, loop aborts, tool error rates, token waste, real prompt-token spend, and whether the observation and palace pipelines are still…

    207 GitHub stars~1.5k tokensUpdated 7 days ago
    Auto-check passed
  • Osx Tuning

    dimetron/pi-go

    Tune macOS resource limits and sysctls for best performance with Go development, Docker/OrbStack, and Linux VMs.

    207 GitHub stars~1.6k tokensUpdated 7 days ago
    Auto-check: notes

Questions about Tui Render Debug

What does Tui Render Debug do?

Diagnose and fix pi-go TUI rendering corruption, especially displaced panels, stale rows, cursor drift, and terminal-specific ANSI incompatibilities. Tui Render Debug is an agent skill from dimetron/pi-go. Diagnose and fix pi-go TUI rendering corruption, especially displaced panels, stale rows, cursor drift, and terminal-specific ANSI incompatibilities.

How do I install Tui Render Debug in Claude Code?

Run `npx skills add dimetron/pi-go --skill tui-render-debug -a claude-code`. Or copy the skill folder (.pi-go/skills/tui-render-debug in dimetron/pi-go) into .claude/skills/tui-render-debug in your project. Claude Code loads it when a task matches its description.

How do I install Tui Render Debug in Codex?

Run `npx skills add dimetron/pi-go --skill tui-render-debug -a codex`. Or copy the skill folder (.pi-go/skills/tui-render-debug in dimetron/pi-go) into .agents/skills/tui-render-debug in your project. Codex loads it when a task matches its description.

Can I use Tui Render Debug in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dimetron/pi-go --skill tui-render-debug -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tui-render-debug, .gemini/skills/tui-render-debug, .github/skills/tui-render-debug and .opencode/skills/tui-render-debug in your project.

What does Tui Render Debug need to run?

Going by SKILL.md and its folder, Tui Render Debug needs the command-line tools its instructions call (rg).

Does Tui Render Debug access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tui Render Debug safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Tui Render Debug use?

Tui Render Debug is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tui Render Debug use?

About 783 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tui Render Debug?

Skills that share tags, products or a category with Tui Render Debug: Debug (asgeirtj/system_prompts_leaks, 69k stars), Debug Tui (trasta298/keifu, 811 stars), Tui Debug In Pane (mikeyobrien/ralph-orchestrator, 3.2k stars) and Openclaw Debugging (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tui Render Debug?

dimetron (a GitHub user) maintains it in dimetron/pi-go, which has 207 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 1, 2026.

Source: dimetron/pi-go on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.