What problem does it solve? Opening a markdown file in a cmux right pane often fails: cmux markdown open spawns a new pane every time, and moving that surface into an existing right pane with move-surface causes the viewer to render completely blank. This Skill documents the only two reliable approaches so you never end up with a stray pane or an empty viewer. ## Core Features & Use Cases - Blank-Render Bug Avoidance: Explains why move-surface on a markdown viewer breaks rendering and forbids that path entirely. - Two Reliable Workflows: Option A opens the markdown correctly the first time with --direction right; Option B closes unused right panes first, then opens a fresh right pane. - Safe Pane Management: Provides exact commands (list-panes, list-pane-surfaces, close-surface) anchored to $CMUX_WORKSPACE_ID so you never close a pane the user is working in. - Use Case: You want to show a generated report.md beside your terminal in cmux. Instead of moving surfaces and getting a blank viewer, you close the stale right pane and run cmux markdown open /abs/path/report.md --direction right --focus false. ## Quick Start Open my markdown file in a cmux right pane without triggering the blank-render bug, closing any unused right panes first if needed.
