Doc Preview Pane

doc-preview-pane

cmux 우측에 단일 프리뷰 pane 을 만들어(이미 있으면 재사용) 마크다운 문서를 네이티브 렌더링으로 보여준다. cmux open 이 .md 를 마크다운 프리뷰 탭으로 렌더링하므로 별도 뷰어 불필요.

When to use

• 아키텍처/설계/플랜 성격의 마크다운을 작성하거나 크게 갱신한 직후 — 사용자가 바로

옆에서 렌더링된 문서를 볼 수 있게 한다.

• 사용자가 "이 문서 오른쪽에 띄워줘 / 보여줘" 라고 요청할 때.

평범한 README 편집, 코드 주석, 한두 줄 수정 등에는 쓰지 않는다 (노이즈).

How to use

작성한 문서의 절대경로로 헬퍼 스크립트를 호출한다:

bash "${CLAUDE_PLUGIN_ROOT}/skills/doc-preview-pane/scripts/show-doc.sh"  [ ...]

• 여러 문서를 한 번에 넘기면 같은 우측 pane 에 탭으로 열린다.
• 포커스는 현재 (agent) pane 에 유지된다 — 작업 흐름이 끊기지 않는다.

Behavior & guarantees

• 단일 pane 재사용: workspace 별로 프리뷰 pane UUID 를 ~/.local/state/cmux-doc-preview/.pane 에 저장. 다음 호출 때 그 pane 이 살아있으면 재사용(탭 추가), 닫혔으면 새로 split. → 호출할수록 화면이 쪼개지지 않음.
• Best-effort: cmux 가 없거나(다른 터미널), workspace 밖이거나, pane 생성/open 이 실패해도 스크립트는 exit 0 으로 조용히 빠진다. 문서는 이미 저장돼 있으니 본 작업에는 영향 없음.
• agent pane 안전: 항상 전용으로 만든 우측 pane 에만 열고, 현재 작업 중인 pane 에는 절대 열지 않는다.

Notes

• 프리뷰 내용이 갱신되면(문서를 다시 쓰면) 같은 경로로 한 번 더 호출하면 된다.
• 우측 pane 을 사용자가 닫았다면 다음 호출 때 자동으로 다시 만든다.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: gw-space
• Source: gw-space/claude-skillbelt
• License: MIT

Install and usage instructions live in the source repository linked above.