About

Imported from sickn33/agentic-awesome-skills (skills/markdown-rendering/SKILL.md). Install upstream with npx skills add sickn33/agentic-awesome-skills --skill markdown-rendering. Copyright stays with the author (MIT).

Markdown Rendering in cmux

Name: markdown-rendering
Author: sickn33

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:

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:

# 1. find panes in THIS workspace
cmux list-panes --workspace "$CMUX_WORKSPACE_ID"

# 2. close the unused/irrelevant right pane(s) by closing their surfaces
cmux list-pane-surfaces --pane pane:NN
cmux close-surface --surface surface:XX     # repeat per surface in that pane

# 3. THEN open the markdown fresh — it creates its own clean right pane
cmux markdown open /abs/path/file.md --direction right --focus false

Hard Rules

Never move-surface a markdown viewer. It renders blank afterward. This is the core bug this skill exists for.
Open it correctly the first time (Option A), OR close the conflicting right pane(s) and open a fresh right pane from scratch (Option B).
Only close panes that are unused or irrelevant — never close a pane the user is working in.
Always anchor to $CMUX_WORKSPACE_ID; never assume the visually focused workspace.
Pass --focus false so you don't steal the user's focus.
You can't screenshot/read a markdown surface to verify it. If unsure it rendered, ask the user.

Limitations

Adapted from davidondrej/skills; verify local paths, tools, credentials, and agent features before acting.
For commands, remote access, scheduling, browser automation, or file-changing workflows, get explicit user approval and confirm the target environment first.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/sickn33-agentic-awesome-skills-markdown-rendering/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

sickn33-agentic-awesome-skills-markdown-rendering.ocm.jsonjson

{
  "ocm": "1",
  "id": "sickn33-agentic-awesome-skills-markdown-rendering",
  "kind": "skill",
  "name": "markdown-rendering",
  "description": "Open Markdown reliably in cmux panes and recover from blank rendered surfaces.",
  "publisher": "sickn33",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "markdown",
      "cmux",
      "rendering",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Open Markdown reliably in cmux panes and recover from blank rendered surfaces."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/sickn33/agentic-awesome-skills",
      "path": "skills/markdown-rendering/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/sickn33/agentic-awesome-skills/blob/HEAD/skills/markdown-rendering/SKILL.md",
      "key": "sickn33/agentic-awesome-skills/skills/markdown-rendering/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# Markdown Rendering in cmux\n\n## When to Use\n\n- Use when opening Markdown in cmux shows a blank pane or wrong layout.\n- Use when you need to display a Markdown file in a stable cmux right pane.\n\n## The Problem\n\n`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.\n\nSo you get stuck: either a stray extra pane, or a blank viewer",
  "cost": {
    "context_tokens": 643
  }
}

Fetch it by URL: GET /api/v1/registry/sickn33-agentic-awesome-skills-markdown-rendering/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.