debug-visual
CommunityDiagnose on-screen visual issues with soma.
System Documentation
What problem does it solve?
This skill helps identify and analyze visual glitches on your desktop by collecting and inspecting X11 events to determine causes such as flicker, focus stealing, or layout thrashing.
Core Features & Use Cases
- Somatic X11 perception: Tap into the X11 event stream to diagnose flicker, focus changes, ghost windows, and layout issues.
- Reproducible analysis: Record timestamps and event sequences to correlate user-reported visuals with system behavior.
- Use Case: When a window flickers continuously, run the debug-visual skill to collect events and present a likely cause with suggested fixes.
Quick Start
Start the diagnostic session by marking the current time with mcp__somatic-temporal__now and prompting the user to reproduce the issue. Then query events via mcp__somatic-x11-bus__get_events and analyze patterns like flicker, focus steal, or ghost windows. Finally, flash a confirmation with mcp__somatic-hud__flash_text.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: debug-visual Download link: https://github.com/brian-wijaya/dotfiles/archive/main.zip#debug-visual Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.