Markdown Rendering

How to reliably open a markdown file in a cmux right pane without it rendering blank. Use whenever opening/showing/rendering a .md file in cmux's right pane via `cmux markdown open`. Covers the move-surface blank-render bug and the only two reliable approaches — open it correctly the first time, or close the existing right pane(s) first then open a fresh right pane.

100 stars 27 forksAI, LLMs & Agents

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add adriannoes/awesome-agentic-ai --skill markdown-rendering
Manual install
git clone --depth 1 https://github.com/adriannoes/awesome-agentic-ai.git /tmp/awesome-agentic-ai
mkdir -p ~/.claude/skills
cp -r /tmp/awesome-agentic-ai/cursor-claude-codex/skills/david-ondrej/agent-orchestration/markdown-rendering ~/.claude/skills/markdown-rendering

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Markdown Rendering in cmux

## 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 markdown fresh as a new right pane:
Read the full skill on GitHub

Details

Skill name
markdown-rendering
Path
cursor-claude-codex/skills/david-ondrej/agent-orchestration/markdown-rendering/SKILL.md
License
MIT
Repo updated
2 November 2026

FAQ

What does the Markdown Rendering skill do?

How to reliably open a markdown file in a cmux right pane without it rendering blank. Use whenever opening/showing/rendering a .md file in cmux's right pane via `cmux markdown open`. Covers the move-surface blank-render bug and the only two reliable approaches — open it correctly the first time, or close the existing right pane(s) first then open a fresh right pane.

How do I install the Markdown Rendering skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add adriannoes/awesome-agentic-ai --skill markdown-rendering. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Markdown Rendering popular?

It lives in adriannoes/awesome-agentic-ai, which has 100 GitHub stars and 27 forks, and is included in 2 curated skill lists.

Related skills

Browserstack

100

adriannoes/awesome-agentic-ai

Run tests on BrowserStack. Use when user mentions "browserstack", "cross-browser", "cloud testing", "browser matrix", "test on safari", "test on firefox", or "browser compatibility".

Testing & QAIn 2 lists27

Coverage

100

adriannoes/awesome-agentic-ai

Analyze test coverage gaps. Use when user says "test coverage", "what's not tested", "coverage gaps", "missing tests", "coverage report", or "what needs testing".

Testing & QAIn 2 lists27

Fix

100

adriannoes/awesome-agentic-ai

Fix failing or flaky Playwright tests. Use when user says "fix test", "flaky test", "test failing", "debug test", "test broken", "test passes sometimes", or "intermittent failure".

Testing & QAIn 2 lists27

Orchestrating LLM Attacks with Pyrit

100

adriannoes/awesome-agentic-ai

Build multi-turn, Crescendo, and Tree-of-Attacks-with-Pruning (TAP) automated attack chains against conversational LLM agents using Microsoft PyRIT, with adversarial chat and scorer feedback loops.

AI, LLMs & AgentsIn 2 lists27

Kickoff

100

adriannoes/awesome-agentic-ai

Use when starting OR continuing a project with the SDD boilerplate. It first discovers the mode — greenfield (starting from scratch) or brownfield (already running) — and routes accordingly. Greenfield runs a Lean Inception interview (vision, personas, MVP). Brownfield maps the current state (as-is), identifies gaps against the SDD standard, and captures historical decisions. Both paths go through the technical kickoff on the 5 axes (tech stack, architecture, infra, quality, observability), propose the project's agentic layer (rules, subagents, skills, workflows/CI), and converge into an incre

AI, LLMs & AgentsIn 2 lists27

Paw Cra Agent Creative Director

118

pawbytes/skill-suites

Creative director and orchestrator for Pawbytes Creative Suites. Use when the user needs creative direction, campaign planning, brand setup, or help choosing the right creative specialist or workflow. Triggers: 'Aria', 'creative direction', 'campaign planning', 'brand setup', 'which creative agent should I use', 'creative suite'.

AI, LLMs & Agents23

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.