markdown-rendering
Open Markdown reliably in cmux panes and recover from blank rendered surfaces.
Profile →npx skills add sickn33/agentic-awesome-skills --skill markdown-rendering --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Markdown Rendering in cmux ## When to Use - Use when opening Markdown in cmux shows a blank pane or wrong layout. - Use when you need to display a Markdown file in a stable cmux right pane. ## The Problem `cmux markdown open` defaults to **spawning a brand-new pane** every time, even with `--direction right`. The common "fix" — moving the new markdown surface into the existing right pane with `move-surface` — **bugs out: the moved viewer renders BLANK.** The surface keeps `type=markdown` and looks healthy, but shows nothing. So you get stuck: either a stray extra pane, or a blank viewer after moving it. ## The Rule You have exactly two reliable options. **Never `move-surface` a markdown viewer** — that is the path that bugs. ### Option A — Open it right on the first try If there is no usable right pane yet, just let cmux create one and leave it where it lands: ```bash cmux markdown open /abs/path/file.md --direction right --focus false ``` Do NOT then move it. If it spawned where you want it, you're done. ### Option B — Close existing right pane(s), then open fresh If there are other right panes in the way (and they're unused or irrelevant), **close them first**, then open the ma
- When to Use
- The Problem
- The Rule
- Option A — Open it right on the first try
- Option B — Close existing right pane(s), then open fresh
- Hard Rules
- Limitations
cmux markdown open /abs/path/file.md --direction right --focus false cmux list-panes --workspace "$CMUX_WORKSPACE_ID" cmux list-pane-surfaces --pane pane:NN cmux close-surface --surface surface:XX # repeat per surface in that pane
What does the markdown-rendering skill do?
Open Markdown reliably in cmux panes and recover from blank rendered surfaces.
How do I install it?
Run `npx skills add sickn33/agentic-awesome-skills --skill markdown-rendering --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.